 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 reads data from the device identified by the open context.
DWORD XXX_Read( DWORD hOpenContext , LPVOID pBuffer , DWORD Count );
Parameters
- hOpenContext
- Handle to the open context of the device. The XXX_Openfunction creates and returns this identifier.
- pBuffer
- Pointer to the buffer which stores the data read from the device. This buffer should be at least Countbytes long.
- Count
- Specifies the number of bytes to read from the device into
pBuffer.
Return Values
Returns 0 for the end-of-file, –1 for an error, or the number of bytes read for success.
Remarks
An application calls the ReadFilefunction to read from the device. The operating system, in turn, invokes this function. The hFileparameter is a handle to your device. The pDataparameter points to the buffer that contains the data read from the device. The Sizeparameter indicates the number of bytes that the application wants to read from the device. The pSizeReadparameter is a pointer to a value where this function can store the number of bytes actually read from the device. The value returned from this function is equal to the value contained in pSizeRead, unless this function returns –1 for an error. If this function returns an error, pSizeReadcontains 0.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later 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.
Last updated on Tuesday, July 13, 2004