Create And Delete Adc Com Object Functions; Itcdeviceopen; Itcdeviceclose - Intermec 700 Series User Manual

SECTION 6

Create and Delete ADC COM Object Functions

Use these functions to create and release ADC COM interfaces.
ITCDEVMGMT.H is the header file and ITCDEVMGMT.LIB is the library.

ITCDeviceOpen

This function opens and initializes a communication channel to the device. In
C++, this function returns a pointer to an interface on which the methods are
called. In C, this function returns a handle, which is the first parameter in each
of the interface function calls.
Syntax:
Parameters:
Return Values:
See Also:

ITCDeviceClose

This function closes the interface opened with ITCDeviceOpen.
Syntax:
Parameters:
Remarks:
HRESULT ITCDeviceOpen( LPCTSTR pszDeviceName, REFIID iid,
ITC_DEVICE_FLAGS eDeviceFlags, void** ppvObject );
pszDevice [in]
iid [in]
eDeviceFlags [in]
ppvObject [out]
HRESULT that indicates success or failure.
ITCDeviceClose
HRESULT ITCDeviceClose( IUnknown** ppvObject );
ppvObject [in,out]
On Windows, this interface decrements the reference count. So
alternatively, IUnknown::Release() could be used and must be used if
reference counting is performed with IUnknown::AddRef(). On DOS, this
function closes all resources associated with the channel.
Pointer to a string that contains the device name on
which to initialize the logical connection. The
device name (Merlin 1) identifies a communications
port. Use "default" for all internal scanners, such
as Imager, SE900, etc. Use "ExtScanner" for
tethered scanners.
The identifier of the interface being requested.
Enumeration that identifies the read
characteristics as follows:
ITC_DHDEVFLAG_READAHEAD
Data is buffered on behalf of the calling
applications. Data Buffering starts after the
first call to IADC::Read ().
ITC_DHDEVFLAG_NODATA
The client application is managing the device to
set its configuration or control its interface but
not to collect data from the device.
A pointer to the interface pointer identified by iid.
If the object does not support this interface,
ppvObject is set to NULL.
A pointer to the interface pointer created by
ITCDeviceOpen. If successful on output, this
pointer is set to NULL.
700 Series Color Mobile Computer User's Manual
Scanner Support
6-11