HWGetBytes

This function gets a number of bytes from the device; the number may be 0.

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

Parameters

  • pContext
    Pointer to a context structure returned by the HWInit function that contains implementation-specific data describing the hardware device.
  • pTargetBuffer
    Pointer to the target buffer in which to put the data.
  • pByteNumber
    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

In Windows CE 3.0 and later, this function has been renamed to HwRxIntrHandler.

This function gets zero or more characters from the hardware receive buffer and puts them into the location pointed to by the second 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 PDDs of serial port drivers.

Requirements

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

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

HWGetIntrType, HWInit

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.