ホーム › Media.WindowsMediaFormat › IWMReaderCallback

IWMReaderCallback

COM

IID96406bd8-2b2b-11d3-b36b-00c04f6108ff継承元IWMStatusCallback自前メソッド開始 vtbl4

公式ドキュメント

IWMReaderCallback は、ファイルから読み取られるデータを処理するためにアプリケーションが実装します。このインターフェースへのポインターは IWMReader::Open に渡されます。

メソッド 1

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

vtbl 4 HRESULT OnSample(DWORD dwOutputNum, ULONGLONG cnsSampleTime, ULONGLONG cnsSampleDuration, DWORD dwFlags, INSSBuffer* pSample, void* pvContext)

OnSample メソッドは、ファイルの読み取り中に(Start の呼び出しによって)呼び出され、新しいデータが利用可能になったことを示します。

dwOutputNum

DWORD

サンプルが属する出力の番号を格納した DWORD。

cnsSampleTime

ULONGLONG

サンプル時刻を 100 ナノ秒単位で格納した QWORD。

cnsSampleDuration

ULONGLONG

サンプルの再生時間を 100 ナノ秒単位で格納した QWORD。ビデオストリームの場合、ファイル作成時にこのサンプルに SampleDuration データユニット拡張が設定されていれば、このパラメーターにはその値が格納されます。SampleDuration の詳細については、INSSBuffer3::GetProperty を参照してください。

dwFlags

DWORD

dwFlags に指定できるフラグには、以下の用途があります。

フラグ	説明
フラグなし	他のフラグの条件がいずれも当てはまりません。たとえば、デルタフレームには、ほとんどの場合フラグは設定されません。
WM_SF_CLEANPOINT	これはキーフレームと同じです。たとえば、シーク時に移動するのに適したポイントを示します。
WM_SF_DISCONTINUITY	データストリームにギャップがあります。これはシーク、ネットワーク損失、その他の理由によるものである可能性があります。これは、コーデックやレンダラーなどのアプリケーションにとって有用な付加情報となります。このフラグは、ギャップの後の最初のデータに設定されます。
WM_SF_DATALOSS	直前のサンプルと、このフラグが設定されたサンプルとの間で、一部のデータが失われています。

pSample

INSSBuffer*

サンプルを格納したオブジェクトの INSSBuffer インターフェースへのポインター。リーダーは、OnSample メソッドが返った後、このポインターに対して SAFE_RELEASE を呼び出します。バッファーの参照カウントを保持する必要がある場合は、このポインターに対して AddRef を呼び出すことができます。AddRef を呼び出していない限り、このポインターに対して Release を呼び出さないでください。

pvContext

void*

アプリケーションが使用する汎用ポインター。このポインターは、IWMReader::Start メソッドに渡されたコンテキストポインターです。

戻り値

このメソッドを使用するには、アプリケーションで実装する必要があります。このメソッドは常に S_OK を返す必要があります。

解説(Remarks)

このメソッドは、出力番号ごとに非圧縮サンプルを受け取るためのものです。単一の出力内の複数のストリームのサンプルを受け取る必要がある場合(相互排他ストリームの場合など)は、IWMReaderCallbackAdvanced::OnStreamSample を使用する必要があります。この場合、圧縮サンプルを受け取ります。リーダーを使用してストリーム番号ごとに非圧縮サンプルを受け取る方法はありません。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IWMReaderCallback "{96406BD8-2B2B-11D3-B36B-00C04F6108FF}"
#usecom global IWMReaderCallback IID_IWMReaderCallback "{}"
#comfunc global IWMReaderCallback_OnSample  4 int,int64,int64,int,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。