次の方法で共有

IMediaFilter::Pause

  • [アーティクル]

Pause メソッドは、フィルタをポーズする。

構文

  HRESULT Pause(void);

戻り値

HRESULT 値を返す。可能な値は次の一覧のとおりである。

値 説明
S_FALSE 移行は完了していない。
S_OK 成功。移行は完了した。

注意

フィルタがポーズ状態のとき、フィルタはサンプルを受け取り、処理し、出力できる。しかし、レンダリング フィルタは、ポーズ中は 1 つのサンプルしか受け入れられない。そのため、フィルタ グラフがポーズ状態のときは、最初のサンプルがレンダラに届くまで、サンプルはグラフ内を移動する。そのとき、ストリーミングは IMediaFilter::Run メソッドが呼び出されるまでポーズ状態となる。ビデオ レンダラは、最初のサンプルを静止画として表示する。

ライブ キャプチャ フィルタは、ポーズ中はサンプルを出力できず、実行中にのみ出力する。

状態移行は非同期の場合がある。移行が完了する前にメソッドが返る場合、戻り値は S_FALSE となる。レンダリング フィルタは、サンプルを 1 つ受け取るまでは状態移行を完了しない。

参照