IPinFlowControl::Block メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

メソッドは Block 、ピンからのデータ フローをブロックまたはブロック解除します。

構文

HRESULT Block(
  [in] DWORD  dwBlockFlags,
  [in] HANDLE hEvent
);

パラメーター

[in] dwBlockFlags

ピンをブロックまたはブロック解除するかどうかを示すフラグ。 次のいずれかの値を指定する必要があります。

• ゼロ: ピンからのデータ フローのブロックを解除します。
• AM_PIN_FLOW_CONTROL_BLOCK: ピンからのデータ フローをブロックします。

[in] hEvent

イベント オブジェクトまたは NULL へのハンドル。 このパラメーターが NULL 以外の場合、メソッドは非同期であり、直ちにを返します。 イベントは、操作の完了時に通知されます。 このパラメーターが NULL の場合、メソッドは同期的であり、ピンがブロックされるまで完了しません。 dwBlockFlags が 0 の場合、このパラメーターは NULL である必要があります。

戻り値

HRESULT 値を返します。 使用可能な値は次のとおりです。

注釈

このメソッドは、同期または非同期にすることができます。

• 非同期的に呼び出すには、 CreateEvent 関数を使用してイベント オブジェクトを作成します。 hEvent パラメーターにイベント ハンドルを渡します。 メソッドは直ちにを返し、操作が完了したときにイベントを通知します。 WaitForSingleObject などの wait 関数を呼び出して、イベントを待機します。
• このメソッドを同期的に呼び出すには、 hEvent パラメーターを NULL に設定 します。 メソッドは、完了するまでブロックします。 メソッドは、ピンがサンプルを配信する準備ができるまで完了しない場合があります。 フィルターが一時停止されている場合、メソッドは無期限にブロックされる可能性があります。 そのため、メイン アプリケーション スレッドから同期的にこのメソッドを呼び出さないでください。

要件

こちらもご覧ください

動的再接続

エラーコードと成功コード

IPinFlowControl インターフェイス