BdaCreateFilterFactory-Funktion (bdasup.h)
Die funktion BdaCreateFilterFactory fügt dem angegebenen Gerät den angegebenen Filterdeskriptor als Filterfactory hinzu und ordnet die Filterfactory der angegebenen BDA-Vorlagentopologie zu.
Syntax
NTSTATUS BdaCreateFilterFactory(
[in] PKSDEVICE pKSDevice,
[in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
[in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);
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.
Rückgabewert
Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.
Bemerkungen
Ein BDA-Minidriver ruft die BdaCreateFilterFactory-Funktion auf, um eine Filterfactory mit einer zugeordneten BDA-Vorlagentopologie zu einem Gerät hinzuzufügen und alle statischen Vorlagenstrukturen der Topologie mit der BDA-Unterstützungsbibliothek (BdaSup.sys) zu registrieren. Die BDA-Unterstützungsbibliothek kann dann die folgenden Methoden- und Eigenschaftsaufrufe verarbeiten:
Wenn ein BDA-Minidriver einen Zeiger auf die neu erstellte Filterfactory erfordert (KSFILTERFACTORY), sollte der Minidriver stattdessen die BdaCreateFilterFactoryEx-Funktion aufrufen.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 |