O'neil Printer Driver; Dtr Driver Installation And Removal; Opening The Dtr Driver - Intermec 700 Series User Manual

Printer Support

O'Neil Printer Driver

The DTR printer communications driver is a Stream Device Driver named
ONEIL.DLL.
All applications use WIN32 API functions to access drivers. Basic operations are
easily implemented by applications through the CreateFile(), WriteFile(),
DeviceIOControl() and CloseHandle() Win32 APIs.
The driver supports communications to 6804DM, 6804T, 6805A, 6806, 6808,
681T, and 781 printers over a selected serial port.

DTR Driver Installation and Removal

Your application must install the device driver by using the RegisterDevice()
function. The driver name is ONEIL.DLL. We recommend that you use "DTR"
for the Device Name parameter, "1" for the Device Driver index parameter, and
use any of the following strings for the last parameter:
"
"
"
"
Use the HANDLE returned by RegisterDevice() as the parameter to
DeregisterDevice(). The correct usage of the RegisterDevice() function call is
demonstrated below. You may use DeregisterDevice() to uninstall the driver.
Install()
{
HANDLE hDevice;
TCHAR port[6];
port[0] = TCHAR('C');
port[1] = TCHAR('O');
port[2] = TCHAR('M');
port[3] = TCHAR('1');
port[4] = TCHAR(':');
port[5] = TCHAR(0);
hDevice = RegisterDevice ( (TEXT("DTR"), 1, TEXT("\\WINDOWS\\ONEIL.DLL"),
(DWORD)port);
}

Opening the DTR Driver

The application opens the DTR driver by using the CreateFile() function. The call
can be implemented as follows:
hFile = CreateFile(_T("DTR1:"), GENERIC_WRITE, 0, NULL, OPEN_ALWAYS,
FILE_ATTRIBUTE_NORMAL, NULL);
The first parameter "DTR1:" must reflect the device name and index used in the
RegisterDevice() function call.
The function call will fail for any of the following reasons:
"
"
"
"
5-6 700 Series Color Mobile Computer User's Manual
NULL (==0) Defaults to COM1 @ 9600
"COM1" only COM port specified defaults to 9600
"COM1:9600" sets to COM port and specified bit rate
"COM1:19200" sets to COM port and specified bit rate
The port associated with the device during RegisterDevice() is currently in
use.
The DTR device is already open.
The share mode is not set to zero. The device cannot be shared.
Access permissions are not set to GENERIC_WRITE.
SECTION 5