IAsyncReader::SyncRead
Performs a synchronous read.
HRESULT SyncRead(
LONGLONG llPosition,
LONG lLength,
BYTE* pBuffer);
Parameters
- llPosition
[in] Absolute file position. - lLength
[in] Number of bytes required. - pBuffer
[out] Where the data is written.
Return Values
Returns an HRESULT value that depends on the implementation of the interface. Current DirectShow implementation return values include:
Value | Description |
---|---|
VFW_E_BADALIGN | An invalid alignment was specified. |
HRESULT_FROM_WIN32 | Win32 error. |
S_FALSE | Size changed (probably due to end of file). |
S_OK | Success. |
Remarks
The SyncRead method works in a stopped state as well as in a running state. The read is not necessarily aligned. This method fails if the read is beyond the actual total length.
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.