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

IOverlay

COM
IID56a868a1-0ad4-11ce-b03a-0020af0ba770継承元IUnknown自前メソッド開始 vtbl3

メソッド 10

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

vtbl 3 HRESULT GetPalette(DWORD* pdwColors, PALETTEENTRY** ppPalette)
pdwColorsDWORD*inout返されるパレットエントリ数を受け取る出力先。
ppPalettePALETTEENTRY**out現在のパレット(PALETTEENTRY配列)を受け取る出力先。CoTaskMemFreeで解放する。
vtbl 4 HRESULT SetPalette(DWORD dwColors, PALETTEENTRY* pPalette)
dwColorsDWORDinpPalette配列のパレットエントリ数。
pPalettePALETTEENTRY*in設定するパレット(PALETTEENTRY配列)へのポインタ。
vtbl 5 HRESULT GetDefaultColorKey(COLORKEY* pColorKey)
pColorKeyCOLORKEY*out既定のカラーキー(COLORKEY)を受け取る出力先。
vtbl 6 HRESULT GetColorKey(COLORKEY* pColorKey)
pColorKeyCOLORKEY*out現在のカラーキー(COLORKEY)を受け取る出力先。
vtbl 7 HRESULT SetColorKey(COLORKEY* pColorKey)
pColorKeyCOLORKEY*inout設定するカラーキー(COLORKEY)を指定する入出力。調整後値が返る場合がある。
vtbl 8 HRESULT GetWindowHandle(HWND* pHwnd)
pHwndHWND*outオーバーレイ表示先のウィンドウハンドル(HWND)を受け取る出力先。
vtbl 9 HRESULT GetClipList(RECT* pSourceRect, RECT* pDestinationRect, RGNDATA** ppRgnData)
pSourceRectRECT*out現在のソース矩形(RECT)を受け取る出力先。
pDestinationRectRECT*out現在の出力先矩形(RECT)を受け取る出力先。
ppRgnDataRGNDATA**out現在のクリッピング領域(RGNDATA)を受け取る出力先。CoTaskMemFreeで解放する。
vtbl 10 HRESULT GetVideoPosition(RECT* pSourceRect, RECT* pDestinationRect)
pSourceRectRECT*out現在のビデオソース矩形(RECT)を受け取る出力先。
pDestinationRectRECT*out現在のビデオ出力先矩形(RECT)を受け取る出力先。
vtbl 11 HRESULT Advise(IOverlayNotify* pOverlayNotify, DWORD dwInterests)
pOverlayNotifyIOverlayNotify*inオーバーレイ変更通知を受け取るIOverlayNotifyを指定する。
dwInterestsDWORDin通知を希望するイベント種別を示すADVISE_*フラグの論理和。
vtbl 12 HRESULT Unadvise()

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_IOverlay "{56A868A1-0AD4-11CE-B03A-0020AF0BA770}"
#usecom global IOverlay IID_IOverlay "{}"
#comfunc global IOverlay_GetPalette          3 var,var
#comfunc global IOverlay_SetPalette          4 int,var
#comfunc global IOverlay_GetDefaultColorKey  5 var
#comfunc global IOverlay_GetColorKey         6 var
#comfunc global IOverlay_SetColorKey         7 var
#comfunc global IOverlay_GetWindowHandle     8 sptr
#comfunc global IOverlay_GetClipList         9 var,var,var
#comfunc global IOverlay_GetVideoPosition    10 var,var
#comfunc global IOverlay_Advise              11 sptr,int
#comfunc global IOverlay_Unadvise            12
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。