IAMGraphBuilderCallback::CreatedFilter メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
Filter Graph Manager は、フィルターを作成した後、フィルターの接続を試みる前に、このメソッドを呼び出します。
構文
HRESULT CreatedFilter(
IBaseFilter *pFil
);
パラメーター
pFil
フィルターの IBaseFilter インターフェイスへのポインター。
戻り値
メソッドから成功コードが返された場合、フィルター グラフ マネージャーはフィルターの接続を試みます。 メソッドからエラー コードが返された場合、フィルター グラフ マネージャーはフィルターを拒否します。
注釈
このメソッドを使用すると、クライアントは作成直後にフィルターを構成できます。 Video Mixing Renderer は、接続する前に構成が必要なフィルターの主な例です。 他のほとんどの DirectShow フィルターは、接続後に構成できます。
Filter Graph Manager は、このメソッドを呼び出す間、グラフ全体のクリティカル セクションを保持します。 そのため、コールバック メソッドは、Filter Graph Manager でメソッドを呼び出したり、グラフの状態を変更する可能性があるフィルター (ピンの切断など) のメソッドを呼び出さないようにする必要があります。 これを行うと、デッドロックやその他の予期しない動作が発生する可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |
| Library | Strmiids.lib |