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

IDVBSLocator

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID3d7c353c-0d04-45f1-a742-f97cc1188dc8継承元IDigitalLocator呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl22

公式ドキュメント

IDVBSLocator インターフェイスは DVBSLocator オブジェクトに実装されます。

解説(Remarks)

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

メソッド 10

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

vtbl 22 HRESULT get_SignalPolarisation(Polarisation* PolarisationVal)

get_SignalPolarisation メソッドは信号の偏波を取得します。

PolarisationValPolarisation*out偏波値を受け取る Polarisation 型の変数へのポインター。

戻り値

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

解説(Remarks)

このメソッドおよび関連する列挙型では、規格ドキュメントとの一貫性を保つため "polarisation" のイギリス式綴りを使用しています。

vtbl 23 HRESULT put_SignalPolarisation(Polarisation PolarisationVal)

put_SignalPolarisation メソッドは信号の偏波を設定します。

PolarisationValPolarisationin信号の偏波値を指定する Polarisation 型の変数。

戻り値

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

解説(Remarks)

このメソッドおよび関連する列挙型では、規格ドキュメントとの一貫性を保つため "polarisation" のイギリス式綴りを使用しています。

vtbl 24 HRESULT get_WestPosition(VARIANT_BOOL* WestLongitude)

get_WestPosition メソッドは、軌道位置が東経・西経のいずれで指定されているかを示す値を取得します。

WestLongitudeVARIANT_BOOL*outVARIANT_BOOL 型の変数へのポインター。値が true の場合は「西経」を意味します。

戻り値

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

vtbl 25 HRESULT put_WestPosition(VARIANT_BOOL WestLongitude)

put_WestPosition メソッドは、経度位置を西経または東経として設定します。

WestLongitudeVARIANT_BOOLinこれ以降に続く経度値を西経・東経のいずれとして扱うかを指定します。true は「西経」を意味します。

戻り値

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

vtbl 26 HRESULT get_OrbitalPosition(INT* longitude)

get_OrbitalPosition メソッドは、衛星の軌道位置の設定を取得します。

longitudeINT*out経度の設定を 10 分の 1 度単位で受け取ります。

戻り値

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

vtbl 27 HRESULT put_OrbitalPosition(INT longitude)

put_OrbitalPosition メソッドは、衛星の軌道位置の設定を行います。

longitudeINTin衛星の経度を 10 分の 1 度単位で指定します。

戻り値

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

vtbl 28 HRESULT get_Azimuth(INT* Azimuth)

get_Azimuth メソッドは、パラボラアンテナの位置決めに使用される方位角の設定を取得します。

AzimuthINT*out方位角を 10 分の 1 度単位で受け取ります。

戻り値

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

vtbl 29 HRESULT put_Azimuth(INT Azimuth)

put_Azimuth メソッドは、パラボラアンテナの位置決めに使用される方位角の設定を調整します。

AzimuthINTin方位角を 10 分の 1 度単位で指定します。

戻り値

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

vtbl 30 HRESULT get_Elevation(INT* Elevation)

get_Elevation メソッドは、衛星の仰角を 10 分の 1 度単位で取得します。

ElevationINT*out仰角の設定を 10 分の 1 度単位で受け取ります。

戻り値

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

vtbl 31 HRESULT put_Elevation(INT Elevation)

put_Elevation メソッドは、衛星の仰角を 10 分の 1 度単位で設定します。

ElevationINTin仰角を 10 分の 1 度単位で指定します。

戻り値

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IDVBSLocator "{3D7C353C-0D04-45F1-A742-F97CC1188DC8}"
#usecom global IDVBSLocator IID_IDVBSLocator "{1DF7D126-4050-47F0-A7CF-4C4CA9241333}"
#comfunc global IDVBSLocator_get_SignalPolarisation  22 var
#comfunc global IDVBSLocator_put_SignalPolarisation  23 int
#comfunc global IDVBSLocator_get_WestPosition        24 var
#comfunc global IDVBSLocator_put_WestPosition        25 int
#comfunc global IDVBSLocator_get_OrbitalPosition     26 var
#comfunc global IDVBSLocator_put_OrbitalPosition     27 int
#comfunc global IDVBSLocator_get_Azimuth             28 var
#comfunc global IDVBSLocator_put_Azimuth             29 int
#comfunc global IDVBSLocator_get_Elevation           30 var
#comfunc global IDVBSLocator_put_Elevation           31 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。