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

IVMRImageCompositor9

COM
IID4a5c89eb-df51-4654-ac2a-e48e02bbabf6継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IVMRImageCompositor9 インターフェイスは、Video Mixing Renderer Filter 9 (VMR-9) の既定のコンポジターによって実装されます。

解説(Remarks)

Vmr9.h よりも前に DShow.h と D3d9.h をインクルードしてください。

メソッド 4

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

vtbl 3 HRESULT InitCompositionDevice(IUnknown* pD3DDevice)

InitCompositionDevice メソッドは、新しいコンポジションターゲットが作成されたことをコンポジターに通知します。

pD3DDeviceIUnknown*inDirect3D デバイスオブジェクトの IUnknown インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。取り得る値には次の表に示すものがあります。

戻り値 説明
S_OK
メソッドは成功しました。

解説(Remarks)

Vmr9.h よりも前に DShow.h と D3d9.h をインクルードしてください。

vtbl 4 HRESULT TermCompositionDevice(IUnknown* pD3DDevice)

TermCompositionDevice メソッドは、現在のコンポジションターゲットが置き換えられようとしていることをコンポジターに通知します。コンポジターは、このメソッドでコンポジションターゲットに必要なクリーンアップを実行する必要があります。

pD3DDeviceIUnknown*inDirect3D デバイスオブジェクトの IUnknown インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。取り得る値には次の表に示すものがあります。

戻り値 説明
S_OK
メソッドは成功しました。

解説(Remarks)

Vmr9.h よりも前に DShow.h と D3d9.h をインクルードしてください。

vtbl 5 HRESULT SetStreamMediaType(DWORD dwStrmID, AM_MEDIA_TYPE* pmt, BOOL fTexture)

SetStreamMediaType メソッドは、入力ストリームのメディアタイプを設定します。

dwStrmIDDWORDin入力ストリームを指定します。1 から 16 までの値である必要があります。
pmtAM_MEDIA_TYPE*inメディアタイプを指定する AM_MEDIA_TYPE 構造体へのポインター。
fTextureBOOLinTRUE の場合、ターゲットサーフェスが Direct3D テクスチャサーフェスであることを指定します。

戻り値

このメソッドは HRESULT を返します。取り得る値には次の表に示すものがあります。

戻り値 説明
S_OK
メソッドは成功しました。

解説(Remarks)

Vmr9.h よりも前に DShow.h と D3d9.h をインクルードしてください。

vtbl 6 HRESULT CompositeImage(IUnknown* pD3DDevice, IDirect3DSurface9* pddsRenderTarget, AM_MEDIA_TYPE* pmtRenderTarget, LONGLONG rtStart, LONGLONG rtEnd, DWORD dwClrBkGnd, VMR9VideoStreamInfo* pVideoStreamInfo, DWORD cStreams)

CompositeImage メソッドは、各入力ストリームで利用可能な現在のフレームを合成します。

pD3DDeviceIUnknown*inDirect3D デバイスオブジェクトの IUnknown インターフェイスへのポインター。
pddsRenderTargetIDirect3DSurface9*inすべての描画を実行する対象となる Direct3D サーフェスを指定します。
pmtRenderTargetAM_MEDIA_TYPE*inターゲットサーフェスのメディアタイプを含む AM_MEDIA_TYPE 構造体へのポインター。
rtStartLONGLONGin開始時刻を指定します。
rtEndLONGLONGin終了時刻を指定します。
dwClrBkGndDWORDin背景色を D3DCOLOR 型として指定します。
pVideoStreamInfoVMR9VideoStreamInfo*in各ビデオストリームを記述する VMR9VideoStreamInfo 構造体の配列へのポインター。
cStreamsDWORDinミックスするストリームの数を指定します。これは pVideoStreamInfo 配列のサイズでもあります。

戻り値

このメソッドは HRESULT を返します。取り得る値には次の表に示すものがあります。

戻り値 説明
S_OK
メソッドは成功しました。

解説(Remarks)

Vmr9.h よりも前に DShow.h と D3d9.h をインクルードしてください。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IVMRImageCompositor9 "{4A5C89EB-DF51-4654-AC2A-E48E02BBABF6}"
#usecom global IVMRImageCompositor9 IID_IVMRImageCompositor9 "{}"
#comfunc global IVMRImageCompositor9_InitCompositionDevice  3 sptr
#comfunc global IVMRImageCompositor9_TermCompositionDevice  4 sptr
#comfunc global IVMRImageCompositor9_SetStreamMediaType     5 int,var,int
#comfunc global IVMRImageCompositor9_CompositeImage         6 sptr,sptr,var,int64,int64,int,var,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。