 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function retrieves the list of serial devices. In Windows CE 2.12 and earlier, the function had this prototype:
PDEVICE_LIST GetSerialObject(void);
Return Values
The DEVICE_LISTstructure that contains information about the devices supported in this implementation.
In Windows CE 3.0 and later, GetSerialObjecthas a new prototype:
PHWOBJ GetSerialObject( DWORD DeviceArrayIndex);
Parameters
- DeviceArrayIndex
- An index into an array of serial devices, corresponding to the
different PDD implementations that may be shared by a single MDD
implementation.
Return Values
A pointer to a HWOBJstructure, which contains the correct function pointers and parameters for the relevant PDD layer's DDSI functions.
Remarks
This function is part of the implementation of the PDDs of serial port drivers. A single function driver would contain only one element in its device list. Drivers which integrate multiple PDDs in one DLL should create a device element for each PDD instance.
In Windows CE 3.0 and later, GetSerialObjectmust always be called before a serial port is initialized. The serial port MDD layer will always call GetSerialObjectbefore calling HWInit.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Serhw.h Serhw.h
Last updated on Tuesday, July 13, 2004