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

IVMRSurfaceAllocator9

COM
IID8d5148ea-3f5d-46cf-9df1-d1b896eedb1f継承元IUnknown自前メソッド開始 vtbl3

メソッド 4

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

vtbl 3 HRESULT InitializeDevice(UINT_PTR dwUserID, VMR9AllocationInfo* lpAllocInfo, DWORD* lpNumBuffers)
dwUserIDUINT_PTRinアロケータを一意に識別する呼び出し側定義のユーザーID。AdviseSurfaceAllocatorで渡した値が返る。
lpAllocInfoVMR9AllocationInfo*in確保すべきサーフェスの形式・サイズ・用途を記述するVMR9AllocationInfo構造体へのポインタ。
lpNumBuffersDWORD*inout入力で要求バッファ数、出力で実際に確保された数を受け取るDWORDへのポインタ。
vtbl 4 HRESULT TerminateDevice(UINT_PTR dwID)
dwIDUINT_PTRin破棄対象のデバイスを示すユーザーID。InitializeDeviceで渡したdwUserIDに対応する。
vtbl 5 HRESULT GetSurface(UINT_PTR dwUserID, DWORD SurfaceIndex, DWORD SurfaceFlags, IDirect3DSurface9** lplpSurface)
dwUserIDUINT_PTRin対象アロケータを識別する呼び出し側定義のユーザーID。
SurfaceIndexDWORDin取得するサーフェスの0起点インデックス。確保したバッファ数未満を指定する。
SurfaceFlagsDWORDinサーフェス取得時の動作を指定するフラグ。通常は0を指定する。
lplpSurfaceIDirect3DSurface9**out取得したIDirect3DSurface9インターフェイスを受け取る出力ポインタ。呼び出し側が解放する。
vtbl 6 HRESULT AdviseNotify(IVMRSurfaceAllocatorNotify9* lpIVMRSurfAllocNotify)
lpIVMRSurfAllocNotifyIVMRSurfaceAllocatorNotify9*inアロケータがVMR9へ通知を返すためのIVMRSurfaceAllocatorNotify9インターフェイスへのポインタ。

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 指定が可能。