IMFSampleGrabberSinkCallback2::OnProcessSampleEx メソッド (mfidl.h)

サンプル グラバー シンクが新しいメディア サンプルを受け取ったときに呼び出されます。

構文

HRESULT OnProcessSampleEx(
  [in] REFGUID       guidMajorMediaType,
  [in] DWORD         dwSampleFlags,
  [in] LONGLONG      llSampleTime,
  [in] LONGLONG      llSampleDuration,
  [in] const BYTE    *pSampleBuffer,
  [in] DWORD         dwSampleSize,
  [in] IMFAttributes *pAttributes
);

パラメーター

[in] guidMajorMediaType

データの形式を指定するメジャー型 GUID。 使用可能な値の一覧については、「 メジャー メディアの種類」を参照してください。

[in] dwSampleFlags

サンプル フラグ。 サンプル グラバー シンクは、メディア サンプルの IMFSample::GetSampleFlags メソッドを呼び出すことによって、このパラメーターの値を取得します。

[in] llSampleTime

このサンプルのプレゼンテーション時間 (100 ナノ秒単位)。 サンプルにプレゼンテーション時間がない場合、このパラメーターの値は _I64_MAX

[in] llSampleDuration

サンプルの期間 (100 ナノ秒単位)。

サンプルに期間がない場合、このパラメーターの値は _I64_MAX。

[in] pSampleBuffer

サンプル データを含むバッファーへのポインター。

[in] dwSampleSize

pSampleBuffer バッファーのサイズ (バイト単位)。

[in] pAttributes

IMFAttributes インターフェイスへのポインター。 このインターフェイスを使用して、このサンプルの属性を取得します (存在する場合)。 サンプル属性の一覧については、「 サンプル属性」を参照してください。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

再生トポロジでサンプル グラバー シンクを使用する場合、このメソッドはすぐに戻る必要があります。または、再生に干渉する可能性があります。 スレッドをブロックしたり、イベントを待機したり、このメソッド内で他の長い操作を実行したりしないでください。

要件

サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfidl.h

関連項目

IMFSampleGrabberSinkCallback2