IVMRSurfaceAllocator9
COM公式ドキュメント
IVMRSurfaceAllocator9 インターフェイスは、Video Mixing Renderer Filter 9 (VMR-9) の既定のアロケーター/プレゼンターによって実装されます。
解説(Remarks)
Vmr9.h の前に DShow.h と D3d9.h をインクルードしてください。
メソッド 4
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
InitializeDevice メソッドは、Video Mixing Renderer 9 (VMR-9) がアロケーター/プレゼンターにサーフェスを割り当てさせる必要があるときに呼び出されます。
| dwUserID | UINT_PTR | in | アプリケーション定義の識別子。この値は、アプリケーションが IVMRSurfaceAllocatorNotify9::AdviseSurfaceAllocator メソッドの dwUserID パラメーターに渡した値と同じです。 |
| lpAllocInfo | VMR9AllocationInfo* | in | 作成するサーフェスの記述を格納した VMR9AllocationInfo 構造体へのポインター。 |
| lpNumBuffers | DWORD* | inout | 入力時には、作成するサーフェスの数を指定します。メソッドが戻ると、このパラメーターには実際に割り当てられたバッファーの数が格納されます。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表の値が含まれます。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
VMR-9 用のカスタムアロケーター/プレゼンターを提供する場合は、このメソッドを実装してください。サーフェスの割り当てには、VMR-9 の IVMRSurfaceAllocatorNotify9::AllocateSurfaceHelper メソッドを使用できます。
Vmr9.h の前に DShow.h と D3d9.h をインクルードしてください。
TerminateDevice メソッドは、Direct3D デバイスを解放します。
| dwID | UINT_PTR | in | アプリケーション定義の識別子。この値は、アプリケーションが IVMRSurfaceAllocatorNotify9::AdviseSurfaceAllocator メソッドの dwUserID パラメーターに渡した値と同じです。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表の値が含まれます。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
Vmr9.h の前に DShow.h と D3d9.h をインクルードしてください。
GetSurface メソッドは、アロケーター/プレゼンターから Direct3D サーフェスを取得します。
| dwUserID | UINT_PTR | in | アプリケーション定義の識別子。この値は、アプリケーションが IVMRSurfaceAllocatorNotify9::AdviseSurfaceAllocator メソッドの dwUserID パラメーターに渡した値と同じです。 |
| SurfaceIndex | DWORD | in | 取得するサーフェスのインデックスを指定します。 |
| SurfaceFlags | DWORD | in | 予約済みです。 |
| lplpSurface | IDirect3DSurface9** | out | IDirect3DSurface9 インターフェイスへのポインターを受け取ります。呼び出し元はこのインターフェイスを解放する必要があります。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表の値が含まれます。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
Vmr9.h の前に DShow.h と D3d9.h をインクルードしてください。
AdviseNotify メソッドは、通知コールバック用の VMR-9 フィルターのインターフェイスをアロケーター/プレゼンターに提供します。
| lpIVMRSurfAllocNotify | IVMRSurfaceAllocatorNotify9* | in | アロケーター/プレゼンターが VMR に通知を返すために使用する IVMRSurfaceAllocatorNotify9 インターフェイスを指定します。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表の値が含まれます。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
Vmr9.h の前に DShow.h と D3d9.h をインクルードしてください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IVMRSurfaceAllocator9 "{8D5148EA-3F5D-46CF-9DF1-D1B896EEDB1F}" #usecom global IVMRSurfaceAllocator9 IID_IVMRSurfaceAllocator9 "{}" #comfunc global IVMRSurfaceAllocator9_InitializeDevice 3 sptr,var,var #comfunc global IVMRSurfaceAllocator9_TerminateDevice 4 sptr #comfunc global IVMRSurfaceAllocator9_GetSurface 5 sptr,int,int,sptr #comfunc global IVMRSurfaceAllocator9_AdviseNotify 6 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IVMRSurfaceAllocator9 "{8D5148EA-3F5D-46CF-9DF1-D1B896EEDB1F}" #usecom global IVMRSurfaceAllocator9 IID_IVMRSurfaceAllocator9 "{}" #comfunc global IVMRSurfaceAllocator9_InitializeDevice 3 sptr,sptr,sptr #comfunc global IVMRSurfaceAllocator9_TerminateDevice 4 sptr #comfunc global IVMRSurfaceAllocator9_GetSurface 5 sptr,int,int,sptr #comfunc global IVMRSurfaceAllocator9_AdviseNotify 6 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。