This method receives the next block of data from the stream.
HRESULT Receive( IMediaSample* pSample );
[in] Pointer to a media sample.
Returns an HRESULT value that depends on the implementation. HRESULT can be one of the following standard constants, or other values not listed.
|E_POINTER||Null pointer argument.|
|E_NOTIMPL||Method is not supported.|
|S_OK or NOERROR||Success.|
This is a blocking synchronous call. Typically, no blocking occurs, but if a filter cannot process the sample immediately it may use the calling application's thread to wait until it can.
Use the IUnknown::AddRef method if you need to hold the returned data block beyond the completion of the IMemInputPin::Receive method. If you use AddRef, be sure to use IUnknown::Release when done with it.
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.
Last updated on Wednesday, April 13, 2005
© 2005 Microsoft Corporation. All rights reserved.