BdaCreateFilterFactory-Funktion (bdasup.h)
Die BdaCreateFilterFactory-Funktion 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 zugeordneter 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 bei der erstmaligen Initialisierung des Filters nicht alle Pin- und Knotentypen der Vorlage als Pin- und Node-Factorys verfügbar gemacht werden können.
[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.
Hinweise
Ein BDA-Minidriver ruft die BdaCreateFilterFactory-Funktion auf, um einem Gerät eine Filterfactory mit einer zugeordneten BDA-Vorlagentopologie hinzuzufügen und alle statischen Vorlagenstrukturen der Topologie bei 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 (KSFILTERFACTORY) erfordert, sollte der Minidriver stattdessen die BdaCreateFilterFactoryEx-Funktion aufrufen.Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar unter Microsoft Windows XP und höheren Betriebssystemen. |
| Zielplattform | Desktop |
| Kopfzeile | bdasup.h (include Bdasup.h) |
| Bibliothek | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |