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 questo 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.

Commenti

Un minidriver BDA chiama la funzione BdaPropertyNodeDescriptors 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 la funzione BdaPropertyNodeDescriptors , senza intercettare questa richiesta usando un gestore get-interno (KStrGetPropertyHandler). Per altre informazioni, vedere Definizione delle tabelle di automazione e Determinazione della topologia del dispositivo BDA .

Per un elenco dei nodi BDA disponibili per la creazione in una topologia modello, vedere GUID categoria di nodi BDA.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows XP e nei sistemi operativi successivi. Questa routine è disponibile nella piattaforma Windows 2000 solo se è installato Microsoft DirectX 9.0 e versioni successive in tale piattaforma.
Piattaforma di destinazione	Desktop
Intestazione	bdasup.h (include Bdasup.h)
Libreria	Bdasup.lib
IRQL	PASSIVE_LEVEL

Vedi anche

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology