Funzione BdaCreateFilterFactory (bdasup.h)

Articolo
02/22/2024

La funzione BdaCreateFilterFactory aggiunge il descrittore di filtro specificato come factory di filtro al dispositivo specificato e associa la factory di filtro alla topologia del modello BDA specificata.

Sintassi

NTSTATUS BdaCreateFilterFactory(
  [in] PKSDEVICE                 pKSDevice,
  [in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

Parametri

[in] pKSDevice

Punta al dispositivo BDA a cui aggiungere la factory di filtro con la topologia del modello BDA associata.

[in] pFilterDescriptor

Punta a una struttura KSFILTER_DESCRIPTOR che descrive un filtro per il dispositivo BDA. Si noti che non tutti i tipi di pin e nodo del modello possono essere esposti come pin e node factory quando il filtro viene inizializzato per la prima volta.

[in] pBdaFilterTemplate

Punta a una struttura BDA_FILTER_TEMPLATE che descrive una topologia di modello BDA.

Valore restituito

Restituisce STATUS_SUCCESS o un codice di errore appropriato.

Commenti

Un minidriver BDA chiama la funzione BdaCreateFilterFactory per aggiungere una factory di filtro con una topologia di modello BDA associata a un dispositivo e registrare tutte le strutture modello statiche della topologia con la libreria di supporto BDA (BdaSup.sys). La libreria di supporto BDA può quindi gestire le chiamate al metodo e alle proprietà seguenti:

Se un minidriver BDA richiede un puntatore alla factory di filtro appena creata (KSFILTERFACTORY), il minidriver deve chiamare invece la funzione BdaCreateFilterFactoryEx .

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows XP e nei sistemi operativi successivi.
Piattaforma di destinazione	Desktop
Intestazione	bdasup.h (include Bdasup.h)
Libreria	Bdasup.lib
IRQL	PASSIVE_LEVEL