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 |