HWOBJ

This structure describes the characteristics of serial hardware devices.

typedef struct __HWOBJ {
  PVOID pDeviceParent;
  ULONG BindFlags;
  DWORD dwIntID;
  PVOID pReserved;
  PHW_VTBL pFuncTbl;
} HWOBJ, *PHWOBJ;

Members

  • pDeviceParent
    Pointer back to the DEVICE_LIST structure, which refers to the HWOBJ structure in its DeviceArray member.
  • BindFlags
    Specifies on of the following flags, which control how the upper layer behaves with respect to the driver's interrupt service thread (IST).
    Value Description
    THREAD_IN_PDD The upper layer does nothing; interrupt handling is done in the lower layer.
    THREAD_AT_INIT The upper layer starts the IST when the driver is initialized.
    THREAD_AT_OPEN The upper layer starts the interrupt thread at open time
  • dwIntID
    Specifies the interrupt identifier. For more information on interrupt identifiers, see Creating an Interrupt Identifier. Use these interrupt identifiers with the BindFlags.
  • pReserved
    Not used; set to NULL.
  • pFuncTbl
    Pointer to an HW_VTBL structure that contains a table of function pointers for each of the serial device hardware functions, such as HWOpen, HWClearBreak, HWSetDTR, and so on. HW_VTBL and the full list of functions are declared in the Serhw.h header file.

Remarks

This structure enables one serial driver upper layer to use multiple lower layers for hardware serial ports that have different physical behavior but identical logical behavior, such as an infrared serial port and a standard 9-pin serial port.

Requirements

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

See Also

Creating an Interrupt Identifier | DEVICE_LIST | HW_VTBL | HWOpen | HWClearBreak | HWSetDTR

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.