BdaInitFilter-Funktion (bdasup.h)

Die BdaInitFilter Funktion initialisiert den BDA-Filterkontext, der einer Filterinstanz zugeordnet ist.

Syntax

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

Parameter

[in] pKSFilter

Verweist auf den Filter, in dem der BDA-Filterkontext initialisiert werden soll.

[in] pBdaFilterTemplate

Verweist auf eine BDA_FILTER_TEMPLATE Struktur, die die Filtervorlage für das BDA-Gerät beschreibt. Um die Topologie für den initialisierten Filter zu ermitteln und zu konfigurieren, verwendet der Netzwerkanbieter Informationen, auf die in dieser BDA_FILTER_TEMPLATE Struktur verwiesen wird.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Bemerkungen

Ein BDA-Minidriver ruft die BdaInitFilter--Funktion auf, um eine Instanz eines Filters mithilfe einer bestimmten BDA-Filtervorlage und einer Filterfactory zu initialisieren, die zuvor über einen Aufruf der BdaCreateFilterFactory-Funktion erstellt wurde. Der BDA-Minidriver kann diese Filterinstanz anschließend in Aufrufen anderer BDA-Unterstützungsfunktionen verwenden, z. B. BdaCreatePin.

Wenn ein BDA-Minidriver BdaInitFilteraufruft, erstellt der BDA-Supporttreiber (Bdasup.sys) einen eigenen BDA-Filterkontext. Dieser BDA-Filterkontext ist vom BDA-Minidriver ausgeblendet. Bei Bedarf kann der BDA-Supporttreiber jedoch auf diesen BDA-Filterkontext zugreifen. Der BDA-Unterstützungstreiber fügt diesem BDA-Filterkontext einen Zeiger zum Objektbehälter für das zugeordnete KSFILTER--Objekt hinzu. Wenn das zugeordnete KSFILTER-Objekt zerstört wird, fordert AVStream an, dass der BDA-Supporttreiber diesen BDA-Filterkontext aus dem Objektbehälter löscht. Auf diese Weise kann der BDA-Supporttreiber diesen BDA-Filterkontext zerstören, ohne dass der BDA-Minidriver eingreifen muss.

Anforderungen

Siehe auch

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER-