BdaPropertyNodeDescriptors 関数 (bdasup.h)
BdaPropertyNodeDescriptors 関数は、テンプレート トポロジ内のノードの一覧を取得します。
構文
NTSTATUS BdaPropertyNodeDescriptors(
[in] PIRP pIrp,
[in] PKSPROPERTY pKSProperty,
[out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);
パラメーター
[in] pIrp
ノードの一覧を取得する要求の IRP をポイントします。 BDA ミニドライバーは、KSPROPERTY_BDA_NODE_DESCRIPTORS 要求でこの IRP を受け取ります。
[in] pKSProperty
プロパティ要求のプロパティと要求の種類を記述する KSPROPERTY 構造体を指します。
[out, optional] pNodeDescriptorProperty
テンプレート トポロジ内のノードの GUID の一覧を受け取る配列を指します。
戻り値
STATUS_SUCCESSまたは適切なエラー コードを返します。
備考
BDA ミニドライバーは、BdaPropertyNodeDescriptors 関数を呼び出して、ミニドライバーがネットワーク プロバイダーから設定された KSPROPSETID_BdaTopology プロパティの KSPROPERTY_BDA_NODE_DESCRIPTORS 要求を受け取った後、ノードの一覧を取得します。 ほとんどの BDA ミニドライバーは、ディスパッチおよびフィルターオートメーション テーブルを定義できるため、これらのミニドライバーは、内部 get ハンドラー (KStrGetPropertyHandler) を使用してこの要求をインターセプトすることなく、BdaPropertyNodeDescriptors 関数を直接ディスパッチできます。 詳細については、「Automation テーブル の定義と BDA デバイス トポロジの の決定」を参照してください。
テンプレート トポロジで作成できる BDA ノードの一覧については、「BDA ノード カテゴリ GUID」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Microsoft Windows XP 以降のオペレーティング システムで使用できます。 このルーチンは、Microsoft DirectX 9.0 以降がそのプラットフォームにインストールされている場合にのみ、Windows 2000 プラットフォームで使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | bdasup.h (Bdasup.h を含む) |
| ライブラリ | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
KSPROPERTY を する