Funzione BdaPropertyNodeDescriptors (bdasup.h)
La funzione BdaPropertyNodeDescriptors recupera un elenco di nodi in una topologia modello.
Sintassi
NTSTATUS BdaPropertyNodeDescriptors(
[in] PIRP pIrp,
[in] PKSPROPERTY pKSProperty,
[out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);
Parametri
[in] pIrp
Punta all'IRP per la richiesta per recuperare l'elenco di nodi. Il minidriver BDA riceve l'IRP con la richiesta di KSPROPERTY_BDA_NODE_DESCRIPTORS.
[in] pKSProperty
Punta a una struttura KSPROPERTY che descrive la proprietà e il tipo di richiesta della richiesta di proprietà.
[out, optional] pNodeDescriptorProperty
Punta a una matrice che riceve l'elenco di GUID per i nodi in una topologia modello.
Valore restituito
Restituisce STATUS_SUCCESS o un codice di errore appropriato.
Osservazioni
Un minidriver BDA chiama il BdaPropertyNodeDescriptors funzione per recuperare l'elenco di nodi dopo che il minidriver riceve una richiesta KSPROPERTY_BDA_NODE_DESCRIPTORS del set di proprietà KSPROPSETID_BdaTopology dal provider di rete. La maggior parte dei minidriver BDA può definire tabelle di invio e automazione dei filtri in modo che tali minidriver inviino direttamente il BdaPropertyNodeDescriptors funzione, senza intercettare questa richiesta usando un gestore get interno (KStrGetPropertyHandler). Per altre informazioni, vedere Definizione di tabelle di automazione e Determinazione topologia del dispositivo BDA.
Per un elenco di nodi BDA disponibili per la creazione in una topologia modello, vedere GUID categoria di nodi BDA.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi. Questa routine è disponibile nella piattaforma Windows 2000 solo se Microsoft DirectX 9.0 e versioni successive è installato in tale piattaforma. |
| piattaforma di destinazione | Desktop |
| intestazione | bdasup.h (include Bdasup.h) |
| libreria | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |