CDynamicOutputPin.BlockOutputPin method
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The BlockOutputPin method blocks the pin. While the pin is blocked, the CDynamicOutputPin::StartUsingOutputPin method waits for the pin to become unblocked. The blocked state prevents the output pin from delivering samples, changing its output format, or reconnecting itself.
Syntax
void BlockOutputPin();
Parameters
This method has no parameters.
Return value
This method does not return a value.
Remarks
Before calling this method, hold the CDynamicOutputPin::m_BlockStateLock critical section. Do not call this method if a streaming thread is using the pin, either to deliver data or to change the connection. To check whether a streaming thread is using the pin, call the CDynamicOutputPin::StreamingThreadUsingOutputPin method.
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|