CBaseInputPin::ReceiveCanBlock (Windows CE 5.0)
Determines if the implementation of the IMemInputPin::Receive method might block on the connected output pin.
HRESULT ReceiveCanBlock(void);
Parameters
None.
Return Values
Returns an HRESULT value, which can include one of the following values.
Value | Description |
---|---|
S_FALSE | Input pin will not block on a Receive method. |
S_OK | Input pin might block on a Receive method. |
Remarks
This member function implements the IMemInputPin::ReceiveCanBlock method. The base class implementation calls the IMemInputPin::ReceiveCanBlock method on the input pin connected to each of the filter's output pins.
This member function is useful because an output pin from a filter might require notification if its thread might be blocked when it calls the Receive method on the connected input pin.
For example, a source filter might prefer to keep reading and buffering data rather than be blocked, and might choose to start another thread to wait on the blocking Receive method.
See the COutputQueue base class for queuing samples to input pins that potentially block.
Requirements
DirectShow applications and DirectShow filters have different include file and link library requirements.
For more information, see Setting Up the Build Environment.
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:
Send Feedback on this topic to the authors