IAsyncReader::SyncRead

  • Article

This method 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 the following.

Value Description
VFW_E_BADALIGN An invalid alignment was specified.
HRESULT_FROM_WIN32 Microsoft 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.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.