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
Verweist auf das IRP für die Anforderung, um die Liste der Knoten abzurufen. 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
Verweist 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.
Bemerkungen
Ein BDA-Minidriver ruft die BdaPropertyNodeDescriptors Funktion auf, um die Liste der Knoten abzurufen, nachdem der Minidriver eine KSPROPERTY_BDA_NODE_DESCRIPTORS Anforderung der vom Netzwerkanbieter festgelegten KSPROPSETID_BdaTopology-Eigenschaft empfängt. Die meisten BDA-Minidriver können Verteiler- und Filterautomatisierungs-Tabellen definieren, sodass diese Minidriver die BdaPropertyNodeDescriptors Funktion direkt verteilen, ohne diese Anforderung mithilfe eines internen Get-Handlers abzufangen (KStrGetPropertyHandler). 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 Node Category GUIDs.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar unter Microsoft Windows XP und höher. 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 |
| Header- | bdasup.h (include Bdasup.h) |
| Library | Bdasup.lib |
| IRQL- | PASSIVE_LEVEL |