Funzione BdaPropertyTemplateConnections (bdasup.h)

Articolo
03/08/2023

La funzione BdaPropertyTemplateConnections recupera un elenco di connessioni che descrivono il modo in cui i tipi di pin e i tipi di nodo sono connessi in una topologia di modello.

Sintassi

NTSTATUS BdaPropertyTemplateConnections(
  [in]            PIRP                   pIrp,
  [in]            PKSPROPERTY            pKSProperty,
  [out, optional] PKSTOPOLOGY_CONNECTION pConnectionProperty
);

Parametri

[in] pIrp

Punta all'IRP per la richiesta per recuperare l'elenco di connessioni. Il minidriver BDA riceve l'IRP con la richiesta di KSPROPERTY_BDA_TEMPLATE_CONNECTIONS .

[in] pKSProperty

Punta a una struttura KSPROPERTY che descrive la proprietà e il tipo di richiesta della richiesta di proprietà.

[out, optional] pConnectionProperty

Punta a una matrice che riceve l'elenco di strutture KSTOPOLOGY_CONNECTION che descrivono le connessioni in una topologia modello.

Valore restituito

Restituisce STATUS_SUCCESS o un codice di errore appropriato.

Commenti

Un minidriver BDA chiama la funzione BdaPropertyTemplateConnections per recuperare l'elenco di connessioni modello dopo che il minidriver riceve una richiesta di KSPROPERTY_BDA_TEMPLATE_CONNECTIONS della proprietà KSPROPSETID_BdaTopology impostata dal provider di rete. La maggior parte dei minidriver BDA può definire tabelle di invio e automazione filtro in modo che tali minidriver inviino direttamente la funzione BdaPropertyTemplateConnections , senza intercettare questa richiesta usando un gestore get-handler interno (KStrGetPropertyHandler). Per altre informazioni, vedere Definizione di tabelle di automazione e determinazione della topologia del dispositivo BDA .

Il minidriver BDA ha fornito un elenco di connessioni alla libreria di supporto BDA in una matrice di strutture KSTOPOLOGY_CONNECTION quando il minidriver BDA ha passato il modello di filtro BDA (BDA_FILTER_TEMPLATE) nelle chiamate di funzione BdaCreateFilterFactory e BdaInitFilter . Questa matrice è una rappresentazione di tutte le possibili connessioni tra nodi e tipi di pin che possono essere eseguiti all'interno del filtro o tra il filtro e i filtri adiacenti. La funzione BdaPropertyTemplateConnections restituisce questa matrice.