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

Vedi anche

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology