ホーム › Media.MediaFoundation › IMFSampleGrabberSinkCallback2

IMFSampleGrabberSinkCallback2

COM

IIDca86aa50-c46e-429e-ab27-16d6ac6844cb継承元IMFSampleGrabberSinkCallback自前メソッド開始 vtbl11

公式ドキュメント

IMFSampleGrabberSinkCallback インターフェースを拡張します。

解説(Remarks)

このコールバックインターフェースは、サンプルグラバーシンクで使用されます。IMFSampleGrabberSinkCallback インターフェースを拡張し、IMFSampleGrabberSinkCallback::OnProcessSample メソッドに代わる OnProcessSampleEx メソッドを追加します。

OnProcessSampleEx メソッドは、メディアサンプルの属性を格納するパラメーターを追加します。この属性を使用すると、フィールドドミナンスやテレシネフラグなど、サンプルに関する情報を取得できます。

このインターフェースを使用するには、次の手順を実行します。

このインターフェースを公開するコールバックオブジェクトを実装します。
MFCreateSampleGrabberSinkActivate 関数を呼び出して、サンプルグラバーシンクを作成します。コールバックポインターを pIMFSampleGrabberSinkCallback パラメーターに渡します。
サンプルグラバーシンクは、コールバックオブジェクトに対して QueryInterface を呼び出します。
コールバックオブジェクトが IMFSampleGrabberSinkCallback2 インターフェースを公開している場合、サンプルグラバーシンクは OnProcessSampleEx コールバックメソッドを使用します。それ以外の場合、サンプルグラバーシンクは古い OnProcessSample コールバックメソッドを使用します。

メソッド 1

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 11 HRESULT OnProcessSampleEx(GUID* guidMajorMediaType, DWORD dwSampleFlags, LONGLONG llSampleTime, LONGLONG llSampleDuration, BYTE* pSampleBuffer, DWORD dwSampleSize, IMFAttributes* pAttributes)

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

guidMajorMediaType	GUID*	in	データの形式を指定するメジャータイプ GUID。指定可能な値の一覧については、Major Media Types を参照してください。
dwSampleFlags	DWORD	in	サンプルフラグ。サンプルグラバーシンクは、メディアサンプルの IMFSample::GetSampleFlags メソッドを呼び出して、このパラメーターの値を取得します。
llSampleTime	LONGLONG	in	このサンプルのプレゼンテーション時刻。100 ナノ秒単位で指定します。サンプルにプレゼンテーション時刻がない場合、このパラメーターの値は _I64_MAX になります。
llSampleDuration	LONGLONG	in	サンプルの再生時間。100 ナノ秒単位で指定します。サンプルに再生時間がない場合、このパラメーターの値は _I64_MAX になります。
pSampleBuffer	BYTE*	in	サンプルデータを格納するバッファーへのポインター。
dwSampleSize	DWORD	in	pSampleBuffer バッファーのサイズ (バイト単位)。
pAttributes	IMFAttributes*	in	IMFAttributes インターフェースへのポインター。このインターフェースを使用して、このサンプルの属性 (存在する場合) を取得します。サンプル属性の一覧については、Sample Attributes を参照してください。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

サンプルグラバーシンクを再生トポロジで使用する場合、このメソッドは速やかに戻る必要があります。そうしないと、再生に支障をきたす可能性があります。このメソッド内でスレッドをブロックしたり、イベントを待機したり、その他の時間のかかる処理を実行したりしないでください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IMFSampleGrabberSinkCallback2 "{CA86AA50-C46E-429E-AB27-16D6AC6844CB}"
#usecom global IMFSampleGrabberSinkCallback2 IID_IMFSampleGrabberSinkCallback2 "{}"
#comfunc global IMFSampleGrabberSinkCallback2_OnProcessSampleEx  11 var,int,int64,int64,var,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IMFSampleGrabberSinkCallback2 "{CA86AA50-C46E-429E-AB27-16D6AC6844CB}"
#usecom global IMFSampleGrabberSinkCallback2 IID_IMFSampleGrabberSinkCallback2 "{}"
#comfunc global IMFSampleGrabberSinkCallback2_OnProcessSampleEx  11 sptr,int,int64,int64,sptr,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。