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

IMSVidRect

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID7f5000a6-a440-47ca-8acc-c0e75531a2c2継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

IMSVidRect インターフェイスは、関連付けられたウィンドウハンドルを持つ矩形を表します。

解説(Remarks)

このインターフェイスのインターフェイス識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(IMSVidRect)。

メソッド 11

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Top(INT* TopVal)

get_Top メソッドは、矩形の上端の y 座標を取得します。この座標は、矩形に関連付けられたウィンドウを基準とします。

TopValINT*out上端の y 座標をピクセル単位で受け取る変数へのポインター。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

vtbl 8 HRESULT put_Top(INT TopVal)

put_Top メソッドは、矩形の上端の y 座標を指定します。この座標は、矩形に関連付けられたウィンドウを基準とします。

TopValINTin上端の y 座標をピクセル単位で指定します。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

解説(Remarks)

上端の y 座標を設定すると、矩形の高さも変化します。たとえば、y 座標が 0 で高さが 100 の場合、y 座標を 10 に設定すると高さは 90 に変わります。

vtbl 9 HRESULT get_Left(INT* LeftVal)

get_Left メソッドは、矩形の左端の x 座標を取得します。この座標は、矩形に関連付けられたウィンドウを基準とします。

LeftValINT*out左端の x 座標をピクセル単位で受け取る変数へのポインター。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

vtbl 10 HRESULT put_Left(INT LeftVal)

put_Left メソッドは、矩形の左端の x 座標を指定します。この座標は、矩形に関連付けられたウィンドウを基準とします。

LeftValINTin左端の x 座標をピクセル単位で指定します。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

解説(Remarks)

左端の x 座標を設定すると、矩形の幅も変化します。たとえば、x 座標が 0 で幅が 100 の場合、x 座標を 10 に設定すると幅は 90 に変わります。

vtbl 11 HRESULT get_Width(INT* WidthVal)

get_Width メソッドは、矩形の幅を取得します。

WidthValINT*out幅をピクセル単位で受け取る変数へのポインター。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

解説(Remarks)

IMSVidRect::put_Left メソッドを呼び出すと、矩形の幅が変化します。たとえば、x 座標が 0 で幅が 100 の場合、x 座標を 10 に設定すると幅は 90 に変わります。

vtbl 12 HRESULT put_Width(INT WidthVal)

put_Width メソッドは、矩形の幅を指定します。

WidthValINTin幅をピクセル単位で指定します。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

vtbl 13 HRESULT get_Height(INT* HeightVal)

get_Height メソッドは、矩形の高さを取得します。

HeightValINT*out高さをピクセル単位で受け取る変数へのポインター。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

解説(Remarks)

IMSVidRect::put_Top メソッドを呼び出すと、矩形の高さが変化します。たとえば、y 座標が 0 で高さが 100 の場合、y 座標を 10 に設定すると高さは 90 に変わります。

vtbl 14 HRESULT put_Height(INT HeightVal)

put_Height メソッドは、矩形の高さを指定します。

HeightValINTin高さをピクセル単位で指定します。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

vtbl 15 HRESULT get_HWnd(HWND* HWndVal)

get_HWnd メソッドは、矩形に関連付けられたウィンドウを取得します。

HWndValHWND*outウィンドウへのハンドルを受け取る変数へのポインター。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

vtbl 16 HRESULT put_HWnd(HWND HWndVal)

put_HWnd メソッドは、矩形に関連付けるウィンドウを指定します。

HWndValHWNDinウィンドウへのハンドルを指定します。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

vtbl 17 HRESULT put_Rect(IMSVidRect* RectVal)

put_Rect メソッドは、別の矩形の値をこの矩形にコピーします。

RectValIMSVidRect*inコピー元の矩形の IMSVidRect インターフェイスへのポインターを指定します。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMSVidRect "{7F5000A6-A440-47CA-8ACC-C0E75531A2C2}"
#usecom global IMSVidRect IID_IMSVidRect "{CB4276E6-7D5F-4CF1-9727-629C5E6DB6AE}"
#comfunc global IMSVidRect_get_Top     7 var
#comfunc global IMSVidRect_put_Top     8 int
#comfunc global IMSVidRect_get_Left    9 var
#comfunc global IMSVidRect_put_Left    10 int
#comfunc global IMSVidRect_get_Width   11 var
#comfunc global IMSVidRect_put_Width   12 int
#comfunc global IMSVidRect_get_Height  13 var
#comfunc global IMSVidRect_put_Height  14 int
#comfunc global IMSVidRect_get_HWnd    15 sptr
#comfunc global IMSVidRect_put_HWnd    16 sptr
#comfunc global IMSVidRect_put_Rect    17 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。