IAsyncReader::SyncReadAligned
A version of this page is also available for
4/8/2010
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
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |