IVMRSurfaceAllocatorNotify9
COM公式ドキュメント
IVMRSurfaceAllocatorNotify9 インターフェイスは、Video Mixing Renderer Filter 9 (VMR-9) によって実装されます。
解説(Remarks)
VMR-9 は、レンダーレスモードでのみこのインターフェイスをサポートします。それ以外の場合、QueryInterface は E_NOINTERFACE を返します。詳細については、VMR Modes of Operation を参照してください。
Vmr9.h の前に DShow.h と D3d9.h をインクルードしてください。
メソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
AdviseSurfaceAllocator メソッドは、カスタムのアロケーター/プレゼンターを使用するよう VMR-9 に指示するためにアプリケーションから呼び出されます。
| dwUserID | UINT_PTR | in | この VMR-9 のインスタンスを識別する、アプリケーション定義の値です。 |
| lpIVRMSurfaceAllocator | IVMRSurfaceAllocator9* | in | カスタムサーフェスアロケーターオブジェクト上の IVMRSurfaceAllocator9 インターフェイスへのポインターです。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には、次の表に示すものがあります。
| Return code | Description |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
このメソッドは、VMR の存続期間中に一度だけ呼び出すことができます。VMR は、VMR 自体が削除されるまで、そのアロケーター/プレゼンターを使用し続けます。VMR が最終的に解放されると、カスタムアロケーター/プレゼンターオブジェクトへの参照カウントが解放され、そのオブジェクトを解放できるようになります。
カスタムアロケーター/プレゼンターは、IVMRImagePresenter9 インターフェイスもサポートする必要があります。
Vmr9.h の前に DShow.h と D3d9.h をインクルードしてください。
SetD3DDevice メソッドは、Direct3D デバイスを設定します。
| lpD3DDevice | IDirect3DDevice9* | in | デバイスの IDirect3DDevice9 インターフェイスへのポインターです。 |
| hMonitor | HMONITOR | in | モニターへのハンドルです。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には、次の表に示すものがあります。
| Return code | Description |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
Vmr9.h の前に DShow.h と D3d9.h をインクルードしてください。
ChangeD3DDevice メソッドは、Direct3D デバイスが変更されたことを VMR に通知します。
| lpD3DDevice | IDirect3DDevice9* | in | 新しいデバイスの IDirect3DDevice9 インターフェイスへのポインターです。 |
| hMonitor | HMONITOR | in | 新しいデバイスに関連付けられたモニターへのハンドルです。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には、次の表に示すものがあります。
| Return code | Description |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
Vmr9.h の前に DShow.h と D3d9.h をインクルードしてください。
AllocateSurfaceHelper メソッドは、アプリケーションが指定したパラメーターに基づいて Direct3D サーフェスを割り当てます。
| lpAllocInfo | VMR9AllocationInfo* | in | 作成するサーフェスを記述する VMR9AllocationInfo 構造体へのポインターです。 |
| lpNumBuffers | DWORD* | inout | 入力時、このパラメーターは作成するサーフェスの数を指定します。出力時、このパラメーターにはメソッドが作成したサーフェスの数が格納されます。 |
| lplpSurface | IDirect3DSurface9** | out | IDirect3DSurface9 インターフェイスポインターの配列のアドレスです。配列のサイズは lpNumBuffers の値と等しくなければなりません。このメソッドは、作成した各 Direct3D サーフェスについて、有効な IDirect3DSurface9 ポインターを配列に格納します。呼び出し側はインターフェイスポインターを解放する必要があります。(このメソッドを呼び出す前に、有効なポインターを配列に格納しないでください。メソッドがそれらを上書きし、メモリリークを引き起こすためです。) |
戻り値
このメソッドは HRESULT を返します。取り得る値には、次の表に示すものがあります。
| Return code | Description |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
Vmr9.h の前に DShow.h と D3d9.h をインクルードしてください。
NotifyEvent メソッドは、アロケーター/プレゼンターが割り当てまたはプレゼンテーションの処理中に生成した重要な DirectShow イベントを VMR に通知するために、アロケーター/プレゼンターから呼び出されます。
| EventCode | INT | in | DirectShow のイベントコードを指定します。 |
| Param1 | INT_PTR | in | 最初のイベントパラメーターを指定します。その意味はイベントコードによって異なります。Event Notification Codes を参照してください。 |
| Param2 | INT_PTR | in | 2 番目のイベントパラメーターを指定します。その意味はイベントコードによって異なります。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には、次の表に示すものがあります。
| Return code | Description |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
VMR は、IVMRSurfaceAllocator9::AdviseNotify の呼び出しで、このインターフェイスへのポインターをアロケーター/プレゼンターに渡します。アロケーター/プレゼンターがこのメソッドを呼び出し、EC_ERRORABORT や EC_VMR_RENDERDEVICE_SET などの通常の DirectShow イベントを指定すると、VMR はそのイベントをフィルターグラフマネージャーに渡します。
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_IVMRSurfaceAllocatorNotify9 "{DCA3F5DF-BB3A-4D03-BD81-84614BFBFA0C}" #usecom global IVMRSurfaceAllocatorNotify9 IID_IVMRSurfaceAllocatorNotify9 "{}" #comfunc global IVMRSurfaceAllocatorNotify9_AdviseSurfaceAllocator 3 sptr,sptr #comfunc global IVMRSurfaceAllocatorNotify9_SetD3DDevice 4 sptr,sptr #comfunc global IVMRSurfaceAllocatorNotify9_ChangeD3DDevice 5 sptr,sptr #comfunc global IVMRSurfaceAllocatorNotify9_AllocateSurfaceHelper 6 var,var,sptr #comfunc global IVMRSurfaceAllocatorNotify9_NotifyEvent 7 int,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IVMRSurfaceAllocatorNotify9 "{DCA3F5DF-BB3A-4D03-BD81-84614BFBFA0C}" #usecom global IVMRSurfaceAllocatorNotify9 IID_IVMRSurfaceAllocatorNotify9 "{}" #comfunc global IVMRSurfaceAllocatorNotify9_AdviseSurfaceAllocator 3 sptr,sptr #comfunc global IVMRSurfaceAllocatorNotify9_SetD3DDevice 4 sptr,sptr #comfunc global IVMRSurfaceAllocatorNotify9_ChangeD3DDevice 5 sptr,sptr #comfunc global IVMRSurfaceAllocatorNotify9_AllocateSurfaceHelper 6 sptr,sptr,sptr #comfunc global IVMRSurfaceAllocatorNotify9_NotifyEvent 7 int,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。