Funzione BdaPropertyTemplateConnections (bdasup.h)

Articolo
06/02/2025

La funzione BdaPropertyTemplateConnections recupera un elenco di connessioni che descrivono come 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 questo 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.

Osservazioni

Un minidriver BDA chiama la funzione BdaPropertyTemplateConnections per recuperare l'elenco di connessioni modello dopo che il minidriver riceve una richiesta KSPROPERTY_BDA_TEMPLATE_CONNECTIONS 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 BdaPropertyTemplateConnections 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.

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) in BdaCreateFilterFactory e BdaInitFilter chiamate di funzione. Questa matrice è una rappresentazione di tutte le possibili connessioni tra i tipi di nodo e pin che possono essere effettuati all'interno del filtro o tra il filtro e i filtri adiacenti. La funzione BdaPropertyTemplateConnections restituisce questa matrice.