HWInit (Compact 2013)

  • Article

3/26/2014

This function initializes a serial device.

Syntax

PVOID HWInit(
  ULONG Identifier,
  PVOID pMDDContext,
  PHWOBJ pHWObj
);

Parameters

  • Identifier
    [in] LPCWSTR that contains the registry key of the active device.
  • pMDDContext
    [in] Pointer to a device context used on all function calls to the device driver.

Return Value

A pointer to a context structure that contains implementation-specific data describing the device.

Remarks

This function sets information controlled by the user, such as line control and baud rate. It can also initialize events and interrupts, indirectly managing the initializing of hardware buffers. It is exposed only to the upper layer, and is called only once - when the device driver loads in response to a call to the COM_Init function. For built-in devices, this occurs at boot time.

This function supports the implementation of the lower layers of serial port drivers.

Requirements

Header

serhw.h

See Also

Reference

Serial Port Driver PDD Functions
COM_Init
GetSerialObject
HWOBJ