CBaseStreamControl.NotifyFilterState メソッド

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

メソッドは NotifyFilterState 、フィルターの状態が変化したときにピンに通知します。

構文

void NotifyFilterState(
   FILTER_STATE   new_state,
   REFERENCE_TIME tStart = 0
);

パラメーター

new_state

FILTER_STATE列挙体のメンバーとして、新しい状態を指定します。

tStart

開始時刻を指定します。 新しいフィルター状態がState_Running場合は、 IMediaFilter::Run メソッドの値を渡します。 わからない場合は、既定値を使用します。

戻り値

このメソッドは値を返しません。

解説

このメソッドにより、 CBaseStreamControl::CheckStreamState メソッドが待機を停止します。 所有フィルターが状態を変更するたびに、このメソッドを呼び出します。

例

STDMETHODIMP CMyFilter::Run(REFERENCE_TIME tStart)
{
   /* Do other things needed by the filter ... */
   m_pMyPin->NotifyFilterState(State_Running, tStart);
   return CBaseFilter::Run(tStart); // Call the filter base class.
}

STDMETHODIMP CMyFilter::Pause()
{
   /* Do other things needed by the filter ... */
   m_pMyPin->NotifyFilterState(State_Paused);
   return CBaseFilter::Pause();
}

STDMETHODIMP CMyFilter::Stop()
{
   /* Do other things needed by the filter ... */
   m_pMyPin->NotifyFilterState(State_Stopped);
   return CBaseFilter::Stop();
}

要件

要件	値
ヘッダー	Strmctl.h (Streams.h を含む)
ライブラリ	Strmbase.lib (製品版ビルド); Strmbasd.lib (デバッグ ビルド)

関連項目

CBaseStreamControl クラス