IDistributorNotify インターフェイス (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
IDistributorNotifyインターフェイスを使用すると、フィルター グラフが変更されたときにプラグイン ディストリビューターに通知を受け取ります。
アプリケーションでは、このインターフェイスは使用されません。 プラグイン ディストリビューター (PID) を作成し、PID が制御の通知とフィルター グラフの構成の変更を受け取る必要がある場合は、このインターフェイスを実装します。
Filter Graph Manager は、集約されるすべてのプラグイン ディストリビューターで、このインターフェイスに対してクエリを実行します。 PID でこのインターフェイスが公開されている場合、フィルター グラフ マネージャーは、フィルターで同等の IBaseFilter メソッドを呼び出す前に IDistributorNotify メソッドを呼び出すことによって、状態の変更を PID に通知します。 Filter Graph Manager では、フィルターを追加または削除したり、ピン接続が変更されたりするたびに 、IDistributorNotify::NotifyGraphChange メソッドも呼び出されます。
IDistributorNotify メソッドの呼び出し中は、Filter Graph Manager でメソッドを呼び出す別のコード パスによって保持される可能性のある重要なセクションを保持しないでください。 これにより、デッドロックが発生する可能性があります。
継承
IDistributorNotify インターフェイスは、IUnknown インターフェイスから継承されます。 IDistributorNotify には、次の種類のメンバーもあります。
メソッド
IDistributorNotify インターフェイスには、これらのメソッドがあります。
| IDistributorNotify::NotifyGraphChange NotifyGraphChange メソッドは、フィルター グラフ内のフィルターのセットが変更されるか、ピン接続が変更されたときに呼び出されます。 |
| IDistributorNotify::P ause Pause メソッドは、フィルター グラフが一時停止状態になったときに呼び出されます。 |
| IDistributorNotify::Run Run メソッドは、フィルター グラフが実行中の状態になったときに呼び出されます。 |
| IDistributorNotify::SetSyncSource SetSyncSource メソッドは、新しいクロックが登録されるときに呼び出されます。 |
| IDistributorNotify::Stop Stop メソッドは、フィルター グラフが停止状態になったときに呼び出されます。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |