HWTxIntrHandler (Windows CE 3.0 Device Driver Developement)

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 handles the TX interrupt for serial port devices. For Windows CE 2.12 and earlier, and in the legacy serial port MDD included with Windows CE 3.0, HWTxIntrHandlerhad this prototype:

VOID HWTxIntrHandler(
PVOID
pContext
);

Parameters

pContext

Pointer to a context structure returned by the HWInitfunction that contains implementation-specific data describing the hardware device.

For Windows CE 3.0 and later, HWTxIntrHandler has this prototype:

VOID HWTxIntrHandler(
PVOID
pContext,
PUCHAR
pSourceBuffer,
PULONG
pByteNumber
);

Parameters

pContext

Pointer to a context structure returned by the HWInitfunction that contains implementation-specific data describing the hardware device.

pSourceBuffer

Pointer to the source buffer containing data to be sent.

pByteNumber

When HWTxIntrHandleris called, pByteNumberpoints to the maximum number of bytes to send. When HWTxIntrHandlerreturns, pByteNumberpoints to the actual number of bytes sent.

Remarks

In Windows CE 2.12 and earlier, and in the legacy serial port MDD layer included with Windows CE 3.0, this function clears the transmit interrupt status bit in the hardware and performs any internal bookkeeping necessary so that the HWPutBytesfunction can send data. It is called when the driver detects a transmit interrupt, as set by the HWGetIntrTypefunction. This function supports the implementation of the Serial Port Drivers PDD.

In the current serial port MDD layer included with Windows CE 3.0 and later, this function sends several characters to the hardware transmission buffer from the source buffer. This function is called in response to a transmit interrupt notice from the HWGetIntrTypefunction.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later	Serhw.h	Serhw.h

Note This information applies to the version of Windows CE as provided by Microsoft. Actual implementation is determined by the OEMs, and some Windows CE-based platforms may not support this function.

See Also

HWGetIntrType, HWInit

Last updated on Tuesday, July 13, 2004