 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. |
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 HRESULTvalue 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 SyncReadmethod 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.