BdaPropertyGetControllingPinId 関数 (bdasup.h)
BdaPropertyGetControllingPinId 関数は、特定のノードのプロパティ、メソッド、およびイベントを制御するピンの識別子を取得します。
構文
NTSTATUS BdaPropertyGetControllingPinId(
[in] PIRP Irp,
[in] PKSP_BDA_NODE_PIN Property,
[out, optional] PULONG pulControllingPinId
);
パラメーター
[in] Irp
ノードの制御ピンを取得する要求の IRP を指します。 BDA ミニドライバーは、 KSPROPERTY_BDA_CONTROLLING_PIN_ID 要求でこの IRP を受け取ります。
[in] Property
ノード の制御 ピンを取得するプロパティ要求のプロパティと要求の種類を記述するKSP_BDA_NODE_PIN構造体を指します。
[out, optional] pulControllingPinId
ノードの制御ピンの識別子を受け取る変数を指します。
戻り値
STATUS_SUCCESSまたは適切なエラー コードを返します。
注釈
BDA ミニドライバーは、BdaPropertyGetControllingPinId 関数を呼び出して、ミニドライバーがネットワーク プロバイダーからKSPROPSETID_BdaTopology プロパティ セットのKSPROPERTY_BDA_CONTROLLING_PIN_ID要求を受信した後、ノードの制御ピンの識別子を取得します。 ほとんどの BDA ミニドライバーは、ディスパッチ テーブルとフィルターオートメーション テーブルを定義できるため、これらのミニドライバーは、内部 get ハンドラー (KStrGetPropertyHandler) を使用してこの要求をインターセプトすることなく、BdaPropertyGetControllingPinId 関数を直接ディスパッチできます。 詳細については、「 自動化テーブルの定義 」および 「BDA デバイス トポロジの決定 」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | bdasup.h (Bdasup.h を含む) |
| Library | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |