HWGetBytes (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 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 HWInitfunction 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 HWGetIntrTypefunction.

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