BdaInitFilter-Funktion (bdasup.h)

Die BdaInitFilter-Funktion initialisiert den BDA-Filterkontext, der einem Filter instance 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 bestimmen 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.

Hinweise

Ein BDA-Minidriver ruft die BdaInitFilter-Funktion auf, um eine instance eines Filters mithilfe einer bestimmten BDA-Filtervorlage und einer Filterfactory zu initialisieren, die zuvor durch einen Aufruf der BdaCreateFilterFactory-Funktion erstellt wurde. Der BDA-Minitreiber kann diesen Filter anschließend instance in Aufrufen anderer BDA-Unterstützungsfunktionen wie BdaCreatePin verwenden.

Wenn ein BDA-Minidriver BdaInitFilter aufruft, erstellt der BDA-Unterstützungstreiber (Bdasup.sys) einen eigenen BDA-Filterkontext. Dieser BDA-Filterkontext ist im BDA-Minidriver ausgeblendet. Bei Bedarf kann der BDA-Supporttreiber jedoch auf diesen BDA-Filterkontext zugreifen. Der BDA-Unterstützungstreiber fügt dem Objektbehälter für das zugeordnete KSFILTER-Objekt einen Zeiger auf diesen BDA-Filterkontext hinzu. Wenn das zugeordnete KSFILTER-Objekt zerstört wird, fordert AVStream an, dass der BDA-Unterstützungstreiber 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-Minitreiber eingreifen muss.

Anforderungen

Weitere Informationen

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER