次の方法で共有

CVideoTransformFilter.Receive メソッド

  • [アーティクル]

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

メソッドは Receive 、メディア サンプルを受け取り、それを処理し、出力サンプルをダウンストリーム フィルターに配信します。 このメソッドは 、CTransformFilter::Receive メソッドをオーバーライドします。

構文

HRESULT Receive(
   IMediaSample *pSample
);

パラメーター

pSample

入力サンプルの IMediaSample インターフェイスへのポインター。

戻り値

HRESULT 値を返します。 次の値があります。

リターン コード 説明
S_FALSE
 アップストリーム フィルターはサンプルの送信を停止する必要があります。
S_OK
 成功しました。

解説

このメソッドは CVideoTransformFilter::ShouldSkipFrame を呼び出して、このサンプルを配信するか、単に破棄するかを判断します。 ShouldSkipFrame がFALSE を返す場合 (サンプルを配信する必要があることを示します)、メソッドは次の処理を行います。

  1. CTransformFilter::InitializeOutputSample を呼び出して出力サンプルを準備します
  2. CTransformFilter::Transform を呼び出して入力サンプルを処理します。 このメソッドは純粋仮想であり、派生クラスで実装する必要があります。
  3. CBaseOutputPin::D eliver を呼び出して、出力サンプルを配信します。

また、このメソッドは 、IMediaSample::GetMediaType を呼び出して、入力または出力のサンプルの書式の変更を確認します。 書式の変更がある場合、 メソッドは、対応するピンに接続の種類を設定します。 新しい型を設定する前に、 StopStreaming を呼び出します。 新しい型を設定すると、 StartStreaming が呼び出されます。 派生クラスでは、これらのメソッドを使用して内部状態を更新できます。 派生クラスは、その Transform メソッドで新しい形式をチェックする必要がある場合もあります。

要件

要件 値
ヘッダー
Vtrans.h (Stream.h を含む)
ライブラリ
Strmbase.lib (小売ビルド);
Strmbasd.lib (デバッグ ビルド)

関連項目

CVideoTransformFilter クラス