Funzione BdaInitFilter (bdasup.h)
La funzione BdaInitFilter inizializza il contesto di filtro BDA associato a un'istanza del filtro.
Sintassi
NTSTATUS BdaInitFilter(
[in] PKSFILTER pKSFilter,
[in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);
Parametri
[in] pKSFilter
Punta al filtro in cui inizializzare il contesto di filtro BDA.
[in] pBdaFilterTemplate
Punta a una struttura BDA_FILTER_TEMPLATE che descrive il modello di filtro per il dispositivo BDA. Per determinare la topologia per e configurare il filtro inizializzato, il provider di rete usa le informazioni a cui si fa riferimento in questa struttura BDA_FILTER_TEMPLATE.
Valore restituito
Restituisce STATUS_SUCCESS o un codice di errore appropriato.
Osservazioni
Un minidriver BDA chiama la funzione BdaInitFilter per inizializzare un'istanza di un filtro usando un modello di filtro BDA specifico e una factory di filtro creata in precedenza tramite una chiamata alla funzione BdaCreateFilterFactory. Il minidriver BDA può successivamente usare questa istanza di filtro nelle chiamate ad altre funzioni di supporto BDA, ad esempio BdaCreatePin.
Quando un minidriver BDA chiama BdaInitFilter, il driver di supporto BDA (Bdasup.sys) crea il proprio contesto di filtro BDA. Questo contesto di filtro BDA è nascosto dal minidriver BDA. Tuttavia, quando necessario, il driver di supporto BDA può accedere a questo contesto di filtro BDA. Il driver di supporto BDA aggiunge un puntatore a questo contesto di filtro BDA al contenitore oggetti per l'oggetto KSFILTER associato oggetto. Quando l'oggetto KSFILTER associato viene eliminato definitivamente, AVStream richiede che il driver di supporto BDA elimini questo contesto di filtro BDA dal contenitore oggetti. In questo modo, il driver di supporto BDA può distruggere questo contesto di filtro BDA senza richiedere l'intervento del minidriver BDA.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi. Questa routine è disponibile nella piattaforma Windows 2000 solo se Microsoft DirectX 9.0 e versioni successive è installato in tale piattaforma. |
| piattaforma di destinazione | Desktop |
| intestazione | bdasup.h (include Bdasup.h) |
| libreria | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |