HWRxIntrHandler

  • Article

This function handles receive interrupts for serial port drivers. It gets a number of bytes from the device; the number may be zero.

ULONG HWRxIntrHandler(
  PVOID pContext,
  PUCHAR pTargetBuffer,
  PULONG pByteNumber 
);

Parameters

  • pContext
    [in] Pointer to a context structure returned by the HWInit function that contains implementation-specific data describing the hardware device.
  • pTargetBuffer
    [out] Pointer to the target buffer in which to put the data.
  • pByteNumber
    [in, out] Pointer to, on entry, the maximum number of bytes to read. On exit, the number of bytes read.

Return Values

The return value is the number of bytes dropped by the hardware.

Remarks

This function gets zero or more characters from the hardware receive buffer and puts them into the location pointed to by the pTargetBuffer parameter. If there are no characters available for reading, this function returns immediately. This function is called in response to a receive interrupt indication from the HWGetIntrType function.

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

Requirements

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

See Also

HWGetIntrType | HWInit

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.