IPNPXAssociation
COM公式ドキュメント
PnP-X デバイスの関連付けデータベースエントリを管理するメソッドを定義します。
解説(Remarks)
このインターフェイスは、Function Discovery クエリによって返される関数インスタンスに対して QueryService を呼び出すことで取得します。次の擬似コードは、QueryService 呼び出しで使用するパラメーターを示しています。
QueryService( SID_PNPXAssociation, __uuidof( IPNPXAssociation ) )
IPNPXAssociation のメソッドは、QueryService が呼び出された関数インスタンスの関連付けデータベースエントリを変更します。
すべての関数インスタンスを IPNPXAssociation のメソッドで関連付けできるわけではありません。関数インスタンスは、デバイスの検出に使用された Function Discovery プロバイダーから提供される UUID が PKEY_PNPX_GlobalIdentity キーに設定されている必要があります。プロパティキーの詳細については、PnP-X Provider PKEYs を参照してください。
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
関連付けデータベースエントリを関連付け済みとしてマークします。
| pszSubcategory | LPWSTR | inoptional | エントリが格納されている関連付けデータベースのサブカテゴリ。このパラメーターには NULL を指定できます。 |
戻り値
解説(Remarks)
このメソッドは、IPNPXAssociation インターフェイスの取得元となった関数インスタンスに対応する関連付けデータベースエントリを変更します。
デバイスが関連付けられると、PnP-X Service IP Bus Enumerator (IPBusEnum) が PnP コンポーネントに対してデバイスの devnode を作成する要求を送信します。関連付け後にデバイスドライバーのインストールでユーザーの操作が必要な場合は、新しいハードウェアの検出 ウィザードが表示されます。
関連付けデータベースエントリを関連付け解除済みとしてマークします。
| pszSubcategory | LPWSTR | inoptional | エントリが格納されている関連付けデータベースのサブカテゴリ。このパラメーターには NULL を指定できます。 |
戻り値
解説(Remarks)
このメソッドは、IPNPXAssociation インターフェイスの取得元となった関数インスタンスに対応する関連付けデータベースエントリを変更します。
このメソッドは、関連付けデータベースからエントリを削除しません。関連付けデータベースからエントリを削除するには、IPNPXAssociation::Delete を呼び出します。
関連付けデータベースからエントリを削除します。
| pszSubcategory | LPWSTR | inoptional | エントリが格納されている関連付けデータベースのサブカテゴリ。このパラメーターには NULL を指定できます。 |
戻り値
解説(Remarks)
このメソッドは、IPNPXAssociation インターフェイスの取得元となった関数インスタンスに対応する関連付けデータベースエントリを変更します。
関連付けデータベースエントリを削除せずにデバイスを使用不可としてマークするには、IPNPXAssociation::Unassociate を呼び出します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IPNPXAssociation "{0BD7E521-4DA6-42D5-81BA-1981B6B94075}"
#usecom global IPNPXAssociation IID_IPNPXAssociation "{CEE8CCC9-4F6B-4469-A235-5A22869EEF03}"
#comfunc global IPNPXAssociation_Associate 3 wstr
#comfunc global IPNPXAssociation_Unassociate 4 wstr
#comfunc global IPNPXAssociation_Delete 5 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。