BdaCreateFilterFactoryEx-Funktion (bdasup.h)
Die BdaCreateFilterFactoryEx-Funktion fügt dem angegebenen Gerät den angegebenen Filterdeskriptor 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
Zeigt auf das BDA-Gerät, dem die Filter factory mit zugeordneter BDA-Vorlagentopologie hinzugefügt werden soll.
[in] pFilterDescriptor
Zeigt auf eine KSFILTER_DESCRIPTOR-Struktur , die einen Filter für das BDA-Gerät beschreibt. Beachten Sie, dass nicht alle Pin- und Knotentypen der Vorlagen als Pin- und Knotenfabriken verfügbar gemacht werden, wenn der Filter zuerst initialisiert wird.
[in] pBdaFilterTemplate
Verweist auf eine BDA_FILTER_TEMPLATE-Struktur , die eine BDA-Vorlagentopologie beschreibt.
[out, optional] ppKSFilterFactory
Zeigt 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.
Hinweise
Ein BDA-Minidriver ruft die BdaCreateFilterFactoryEx-Funktion auf, um einem Gerät eine Filter factory 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:
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 Filter factory, gibt sie jedoch 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 |
|---|---|
| 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 |