IAsyncReader::SyncReadAligned

This method performs a synchronous read of the data.

HRESULT SyncReadAligned(
  IMediaSample* pSample
);

Parameters

  • pSample
    Sample to read.

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 Win32 error.
S_FALSE Size changed (probably due to end of file).
S_OK Success.

Remarks

The sample passed in must have been acquired from the agreed allocator. The start and stop positions must be aligned equivalent to an IAsyncReader::Request/IAsyncReader::WaitForNext pair, but may avoid the need for a thread on the source filter.

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.