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-handler (KStrGetPropertyHandler) を使用してこの要求をインターセプトすることなく、BdaPropertyNodeDescriptors 関数を直接ディスパッチできるようにします。 詳細については、 自動化テーブルの定義 と BDA デバイス トポロジの決定 に関するページを参照してください。

テンプレート トポロジで作成できる BDA ノードの一覧については、「 BDA ノード カテゴリ GUID」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Microsoft Windows XP 以降のオペレーティング システムで使用できます。 このルーチンは、そのプラットフォームに Microsoft DirectX 9.0 以降がインストールされている場合にのみ、Windows 2000 プラットフォームで使用できます。
対象プラットフォーム	デスクトップ
Header	bdasup.h (Bdasup.h を含む)
Library	Bdasup.lib
IRQL	PASSIVE_LEVEL

こちらもご覧ください

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology