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

IBDA_PinControl

COM
📘 Microsoft Learn (日本語) · English
IID0ded49d5-a8b7-4d5d-97a1-12b0c195874d継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IBDA_PinControl インターフェイスは、BDA デバイスフィルターのピン上に公開されます。ネットワークプロバイダーは、これらのメソッドを呼び出して、フィルター上の各ピンの種類と識別子を取得します。ネットワークプロバイダーは、グラフを構築する際にこの情報を使用します。

解説(Remarks)

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

メソッド 3

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

vtbl 3 HRESULT GetPinID(DWORD* pulPinID)

GetPinID メソッドは、ピンの ID を取得します。

pulPinIDDWORD*inoutピンの識別子を受け取るポインター。

戻り値

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

vtbl 4 HRESULT GetPinType(DWORD* pulPinType)

GetPinType メソッドは、ピンの種類を取得します。

pulPinTypeDWORD*inoutピンの種類を受け取るポインター。

戻り値

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

vtbl 5 HRESULT RegistrationContext(DWORD* pulRegistrationCtx)

RegistrationContext メソッドは、特定のピンの登録コンテキストを取得します。

pulRegistrationCtxDWORD*inout登録コンテキストを受け取るポインター。

戻り値

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

解説(Remarks)

登録コンテキストは、特定のピンのインスタンスを一意に識別します。ネットワークプロバイダーはこの値を変更せず、グラフ内のピンを追跡するために保持するだけです。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IBDA_PinControl "{0DED49D5-A8B7-4D5D-97A1-12B0C195874D}"
#usecom global IBDA_PinControl IID_IBDA_PinControl "{}"
#comfunc global IBDA_PinControl_GetPinID             3 var
#comfunc global IBDA_PinControl_GetPinType           4 var
#comfunc global IBDA_PinControl_RegistrationContext  5 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。