BdaPropertyNodeDescriptors-Funktion (bdasup.h)

Die BdaPropertyNodeDescriptors-Funktion ruft eine Liste von Knoten in einer Vorlagentopologie ab.

Syntax

NTSTATUS BdaPropertyNodeDescriptors(
  [in]            PIRP               pIrp,
  [in]            PKSPROPERTY        pKSProperty,
  [out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);

Parameter

[in] pIrp

Zeigt auf die IRP für die Anforderung zum Abrufen der Liste der Knoten. Der BDA-Minidriver empfängt diese IRP mit der KSPROPERTY_BDA_NODE_DESCRIPTORS Anforderung.

[in] pKSProperty

Verweist auf eine KSPROPERTY-Struktur , die die Eigenschaft und den Anforderungstyp der Eigenschaftsanforderung beschreibt.

[out, optional] pNodeDescriptorProperty

Zeigt auf ein Array, das die Liste der GUIDs für die Knoten in einer Vorlagentopologie empfängt.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Ein BDA-Minidriver ruft die BdaPropertyNodeDescriptors-Funktion auf, um die Liste der Knoten abzurufen, nachdem der Minidriver eine KSPROPERTY_BDA_NODE_DESCRIPTORS Anforderung der KSPROPSETID_BdaTopology-Eigenschaft vom Netzwerkanbieter erhalten hat. Die meisten BDA-Minidriver können Verteilungs- und Filterautomatisierungstabellen definieren, sodass diese Minidriver die BdaPropertyNodeDescriptors-Funktion direkt senden, ohne diese Anforderung mithilfe eines internen get-Handlers (KStrGetPropertyHandler) abzufangen. Weitere Informationen finden Sie unter Definieren von Automatisierungstabellen und Bestimmen der BDA-Gerätetopologie .

Eine Liste der BDA-Knoten, die in einer Vorlagentopologie erstellt werden können, finden Sie unter BDA-Knotenkategorie-GUIDs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar unter Microsoft Windows XP und höheren Betriebssystemen. Diese Routine ist nur auf der Windows 2000-Plattform verfügbar, wenn Microsoft DirectX 9.0 und höher auf dieser Plattform installiert ist.
Zielplattform	Desktop
Kopfzeile	bdasup.h (include Bdasup.h)
Bibliothek	Bdasup.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology