Funzione BdaInitFilter (bdasup.h)

La funzione BdaInitFilter inizializza il contesto del filtro BDA associato a un'istanza di filtro.

Sintassi

NTSTATUS BdaInitFilter(
  [in] PKSFILTER                 pKSFilter,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

Parametri

[in] pKSFilter

Punta al filtro in cui inizializzare il contesto del 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 fa riferimento in questa struttura BDA_FILTER_TEMPLATE.

Valore restituito

Restituisce STATUS_SUCCESS o un codice di errore appropriato.

Commenti

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 un proprio contesto di filtro BDA. Questo contesto di filtro BDA è nascosto dal minidriver BDA. Tuttavia, se 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 di oggetti per l'oggetto KSFILTER associato. Quando l'oggetto KSFILTER associato viene eliminato, AVStream richiede che il driver di supporto BDA elimini questo contesto di filtro BDA dall'oggetto bag. In questo modo, il driver di supporto BDA può distruggere questo contesto di filtro BDA senza richiedere intervento dal minidriver BDA.

Requisiti

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

Vedi anche

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER