Serial Port Driver PDD Functions

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

The following table shows the serial port driver platform dependent driver (PDD) functions.

Programming element	Description
GetSerialObject	This function returns a pointer to a HWOBJ structure. The structure contains the function pointers and parameters for the hardware interface functions of the relevant lower layer.
HWClearBreak	This function clears an RS-232 line break condition.
HWClearDTR	This function clears the Data Terminal Ready (DTR) signal.
HWClearRTS	This function clears the Request to Send (RTS) signal.
HWClose	This function closes the device initialized by the HWInit function.
HWDeinit	This function is called by the upper layer to de-initialize the hardware when a device driver is unloaded.
HWDisableIR	This function disables the infrared (IR) serial interface.
HWEnableIR	This function enables the infrared (IR) serial interface.
HWGetCommProperties	This function retrieves the current properties of the communications device.
HWGetIntrType	This function returns the current interrupt type.
HWGetModemStatus	This function retrieves the modem status.
HWGetRxBufferSize	This function returns the maximum number of bytes that the hardware buffer can hold, not including the padding, stop, and start bits.
HWGetRxStart	This function returns the start of the hardware-receive buffer.
HWGetStatus	This function specifies the hardware status API.
HWInit	This function initializes a serial device.
HWIoctl	This function executes device I/O control (IOCTL) routines.
HWLineIntrHandler	This function handles line interrupts for serial port devices.
HWModemIntrHandler	This function handles the modem interrupt. In the serial port upper layer implementation available in Windows CE 3.0 and later, this function replaces the HWOtherIntrHandler function.
HWOpen	This function is called by the upper layer to open the serial device.
HWOtherIntrHandler	In Windows CE 3.0 and later, this function has been replaced with the new function HWModemIntrHandler.
HWPostInit	This function performs necessary operations after it initializes all data structures and prepares the serial IST to begin handling interrupts. It is called by the upper layer.
HWPowerOff	This function notifies the platform-dependent driver that the hardware platform is about to enter suspend mode. It is called by the model device driver (MDD).
HWPowerOn	This function notifies the platform-dependent driver that the hardware platform is resuming from suspend mode. It is called by the MDD.
HWPurgeComm	This function purges the communications device.
HWPutBytes	This function writes bytes to hardware. The driver calls this function.
HWReset	This function resets the hardware API.
HWRxIntrHandler	This function handles serial port interrupts.
HWSetBreak	This function sets the line break condition on the transmit line.
HWSetCommTimeouts	This function sets the communications time-out events in response to a call to the SetCommTimeouts function.
HWSetDCB	This function sets the device control block.
HWSetDTR	This function sets the Data Terminal Ready (DTR) signal.
HWSetRTS	This function sets the Request to Send (RTS) signal.
HWTxIntrHandler	This function handles the transmit interrupt for serial port devices.
HWXmitComChar	This function transmits a single character.