BdaCreateFilterFactoryEx-Funktion (bdasup.h)

Artikel
02/06/2025

Die BdaCreateFilterFactoryEx--Funktion fügt dem angegebenen Gerät die angegebene Filterbeschreibung als Filterfactory hinzu und ordnet die Filterfactory der angegebenen BDA-Vorlagentopologie zu.

Syntax

NTSTATUS BdaCreateFilterFactoryEx(
  [in]            PKSDEVICE                 pKSDevice,
  [in]            const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in]            const BDA_FILTER_TEMPLATE *pBdaFilterTemplate,
  [out, optional] PKSFILTERFACTORY          *ppKSFilterFactory
);

Parameter

[in] pKSDevice

Verweist auf das BDA-Gerät, dem die Filterfactory mit der zugeordneten BDA-Vorlagentopologie hinzugefügt werden soll.

[in] pFilterDescriptor

Verweist auf eine KSFILTER_DESCRIPTOR Struktur, die einen Filter für das BDA-Gerät beschreibt. Beachten Sie, dass nicht alle Vorlagen-Pin- und Knotentypen als Pin- und Knotenfabriken verfügbar gemacht werden können, wenn der Filter zum ersten Mal initialisiert wird.

[in] pBdaFilterTemplate

Verweist auf eine BDA_FILTER_TEMPLATE Struktur, die eine BDA-Vorlagentopologie beschreibt.

[out, optional] ppKSFilterFactory

Verweist auf einen Puffer, der einen Zeiger auf eine KSFILTERFACTORY- Struktur für die neu erstellte Filterfactory empfängt.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Bemerkungen

A BDA minidriver calls the BdaCreateFilterFactoryEx function to add a filter factory with an associated BDA template topology to a device and to register all of the topology's static template structures with the BDA support library (BdaSup.sys). Die BDA-Unterstützungsbibliothek kann dann die folgenden Methoden- und Eigenschaftsaufrufe verarbeiten:

Ein BDA-Minidriver ruft BdaCreateFilterFactoryEx- anstelle der BdaCreateFilterFactory-Funktion auf, wenn ein Zeiger auf die neu erstellte KSFILTERFACTORY erforderlich ist. Die BdaCreateFilterFactory-Funktion erstellt auch eine Filterfactory, gibt sie aber nicht an den Aufrufer zurück. Der BDA-Minidriver erfordert einen Zeiger auf die neu erstellte KSFILTERFACTORY, wenn der Minidriver die _KsEdit-Funktion aufrufen muss, um KSFILTERFACTORY zu bearbeiten.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar unter Microsoft Windows XP und höher.
Zielplattform-	Desktop
Header-	bdasup.h (include Bdasup.h)
Library	Bdasup.lib
IRQL-	PASSIVE_LEVEL