次の方法で共有


CTransInPlaceInputPin.NotifyAllocator メソッド

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

メソッドは NotifyAllocator 、接続のアロケーターを指定します。 このメソッドは、 IMemInputPin::NotifyAllocator メソッドを 実装します。

構文

HRESULT NotifyAllocator(
   IMemAllocator *pAllocator,
   BOOL          bReadOnly
);

パラメーター

pAllocator

アロケーターの IMemAllocator インターフェイスへのポインター。

bReadOnly

このアロケーターのサンプルが読み取り専用かどうかを指定するフラグ。 TRUE の場合、サンプルは読み取り専用です。

戻り値

HRESULT 値を返します。 次の表に示す値を指定できます。

リターン コード 説明
S_OK
Success
E_FAIL
障害
E_POINTER
NULL ポインター引数

解説

フィルターは、両方のピン接続に同じアロケーターを使用しようとします。

  • 出力ピンが接続されていない場合、入力ピンはアロケーターを自動的に受け入れます。 出力ピンが接続されると、フィルターによって入力ピンが再接続されます。 その時点で、フィルターは 1 つのアロケーターの使用を再試行します。
  • 出力ピンが接続されている場合、入力ピンはアロケーターを受け入れます。 出力ピンも同じアロケーターを使用します。 ダウンストリーム入力ピンで を呼び出 NotifyAllocator します。

前のケースには、次の例外があります。

  • 提案されたアロケーターが読み取り専用 (つまり 、bReadOnly パラメーターが TRUE) で、フィルターでサンプルを変更する必要がある場合、フィルターは 2 つの異なるアロケーターを使用する必要があります。 この場合、アップストリーム フィルターがダウンストリーム フィルターのアロケーターを使用することを提案している場合、メソッドは E_FAILを返します。

要件

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

関連項目

CTransInPlaceInputPin クラス