Funzione BdaCreateFilterFactory (bdasup.h)
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 |