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 |