Win32 API 日本語リファレンス
ホーム › Media.WindowsMediaFormat › IWMReaderAllocatorEx

IWMReaderAllocatorEx

COM
📘 Microsoft Learn (日本語) · English
IID9f762fa7-a22e-428d-93c9-ac82f3aafe5a継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWMReaderAllocatorEx インターフェイスは、IWMReaderCallbackAdvanced インターフェイスの AllocateForOutput メソッドおよび AllocateForStream メソッドに対する拡張された代替手段を提供します。

メソッド 2

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

vtbl 3 HRESULT AllocateForStreamEx(WORD wStreamNum, DWORD cbBuffer, INSSBuffer** ppBuffer, DWORD dwFlags, ULONGLONG cnsSampleTime, ULONGLONG cnsSampleDuration, void* pvContext)

AllocateForStreamEx メソッドは、IWMReaderCallbackAdvanced::OnStreamSample メソッドに配信されるサンプル用に、ユーザーが作成したバッファーを割り当てます。

wStreamNumWORDinストリーム番号を格納する WORD です。
cbBufferDWORDinppBuffer のサイズ(バイト単位)です。
ppBufferINSSBuffer**outINSSBuffer オブジェクトへのポインターへのポインターです。
dwFlagsDWORDin

関連するフラグを格納する DWORD です。

フラグ 説明
WM_SFEX_NOTASYNCPOINT このフラグは、この SDK の他のメソッドで使用される WM_SF_CLEANPOINT フラグの逆です。ポイントが キーフレーム ではないこと、またはシーク中に移動するのに適したポイントではないことを示します。この逆の定義は、Direct Show との互換性のために使用されます。
WM_SFEX_DATALOSS 前のサンプルと、フラグが設定されたサンプルとの間で、一部のデータが失われています。
cnsSampleTimeULONGLONGinサンプル時間を 100 ナノ秒単位で指定します。
cnsSampleDurationULONGLONGinサンプルの継続時間を 100 ナノ秒単位で指定します。
pvContextvoid*inアプリケーションが使用する汎用ポインターです。このポインターは、IWMReader::Start メソッドに渡されたコンテキストポインターです。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。

解説(Remarks)

このメソッドは、サンプル時間と継続時間の値を渡すことができる点で IWMReaderCallbackAdvanced::AllocateForStream と異なります。

このメソッドの実装内でサンプルを割り当てる際は、INSSBuffer::SetLength を呼び出して、バッファーの長さを、リーダーが cbBuffer パラメーターで渡した長さに設定する必要があります。バッファーに現在の長さを設定しないと、リーダーでエラーが発生する可能性があります。

vtbl 4 HRESULT AllocateForOutputEx(DWORD dwOutputNum, DWORD cbBuffer, INSSBuffer** ppBuffer, DWORD dwFlags, ULONGLONG cnsSampleTime, ULONGLONG cnsSampleDuration, void* pvContext)

AllocateForOutputEx メソッドは、IWMReaderCallback::OnSample メソッドに配信されるサンプル用に、ユーザーが作成したバッファーを割り当てます。

dwOutputNumDWORDin出力番号を格納する DWORD です。
cbBufferDWORDinppBuffer のサイズ(バイト単位)です。
ppBufferINSSBuffer**outINSSBuffer オブジェクトへのポインターへのポインターです。
dwFlagsDWORDin

関連するフラグを格納する DWORD です。

フラグ 説明
WM_SFEX_NOTASYNCPOINT このフラグは、この SDK の他のメソッドで使用される WM_SF_CLEANPOINT フラグの逆です。ポイントが キーフレーム ではないこと、またはシーク中に移動するのに適したポイントではないことを示します。この逆の定義は、DirectShow との互換性のために使用されます。
WM_SFEX_DATALOSS 前のサンプルと、フラグが設定されたサンプルとの間で、一部のデータが失われています。
cnsSampleTimeULONGLONGinサンプル時間を 100 ナノ秒単位で指定します。
cnsSampleDurationULONGLONGinサンプルの継続時間を 100 ナノ秒単位で指定します。
pvContextvoid*inアプリケーションが使用する汎用ポインターです。このポインターは、IWMReader::Start メソッドに渡されたコンテキストポインターです。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。

解説(Remarks)

このメソッドは、サンプル時間と継続時間の値を渡すことができる点で IWMReaderCallbackAdvanced::AllocateForOutput と異なります。

このメソッドの実装内でサンプルを割り当てる際は、INSSBuffer::SetLength を呼び出して、バッファーの長さを、リーダーが cbBuffer パラメーターで渡した長さに設定する必要があります。バッファーに現在の長さを設定しないと、リーダーでエラーが発生する可能性があります。

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