GetSerialObject

  • Article

This function returns a pointer to a HWOBJ structure, which contains the correct function pointers and parameters for the relevant lower layer's hardware interface functions.

PHWOBJ GetSerialObject(
  DWORD DeviceArrayIndex
);

Parameters

  • DeviceArrayIndex
    [in] Index into an array of serial devices, corresponding to the different lower layer implementations that may be shared by a single upper layer implementation.

Return Values

A pointer to a HWOBJ structure, which contains the correct function pointers and parameters for the relevant lower layer's hardware interface functions.

Remarks

This function supports the implementation of the lower layers of serial port drivers. A single function driver would contain only one element in its device list. Drivers that integrate multiple lower layers in one DLL should create a device element for each lower layer instance.

GetSerialObject must always be called before a serial port is initialized.

The serial port upper layer will always call GetSerialObject before calling HWInit.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Serhw.h.

See Also

HWInit | HWOBJ

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.