IAsyncReader::SyncReadAligned (Compact 2013)

3/26/2014

This method performs a synchronous read of the data.

Syntax

HRESULT SyncReadAligned(
  IMediaSample* pSample
);

Parameters

  • pSample
    Sample to read.

Return Value

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

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IAsyncReader Interface