次の方法で共有


IGraphConfig::AddFilterToCache メソッド (strmif.h)

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

メソッドは AddFilterToCache 、フィルター キャッシュにフィルターを追加します。

構文

HRESULT AddFilterToCache(
  [in] IBaseFilter *pFilter
);

パラメーター

[in] pFilter

フィルターの IBaseFilter インターフェイスへのポインター。

戻り値

次のいずれかの HRESULT 値を 返します。

リターン コード 説明
E_FAIL
失敗しました。
E_POINTER
NULL ポインター引数。
S_FALSE
フィルターは既にキャッシュ内にあります。
S_OK
フィルターがキャッシュに追加されました。

注釈

このメソッドを呼び出す前に、フィルターのすべてのピンを切断する必要があります。または、 メソッドが失敗します。 フィルターがフィルター グラフ内にある場合、このメソッドはそれを削除します。 このメソッドでは、フィルターがまだない場合は、停止状態になります。

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)
Library Strmiids.lib

こちらもご覧ください

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

IGraphConfig インターフェイス