KsRegisterFilterWithNoKSPins-Funktion (ks.h)
Die KsRegisterFilterWithNoKSPins-Funktion registriert sich mit DirectShow-Filtern, die keine Kernelstreaming-Pins haben und daher nicht im Kernelmodus streamen.
Syntax
KSDDKAPI NTSTATUS KsRegisterFilterWithNoKSPins(
[in] PDEVICE_OBJECT DeviceObject,
[in] const GUID *InterfaceClassGUID,
[in] ULONG PinCount,
[in] BOOL *PinDirection,
[in] KSPIN_MEDIUM *MediumList,
[in, optional] GUID *CategoryList
);
Parameter
[in] DeviceObject
Ein Zeiger auf eine DEVICE_OBJECT Struktur, die dem Gerät entspricht, bei dem der Filter registriert werden soll.
[in] InterfaceClassGUID
Ein Zeiger auf die GUID, die die zu registrierende Klasse darstellt. Für instance weist dies auf KSCATEGORY_TVTUNER für einen TvTuner-Filter hin.
[in] PinCount
Die Anzahl der Pins für den Filter.
[in] PinDirection
Ein Zeiger auf das erste Element eines Arrays boolescher Werte, das die Pinrichtung für jeden Pin im Filter angibt. Ausgabepins sind TRUE; Eingabenadeln sind FALSE. Dieses Array muss pinCount lang sein.
[in] MediumList
Ein Zeiger auf das erste Element eines Arrays von KSPIN_MEDIUM Strukturen, die die Medien für jeden Pin auf dem Filter definieren. Dieses Array muss pinCount lang sein.
[in, optional] CategoryList
Ein Zeiger auf das erste Element eines Arrays von GUIDs, die die Kategorien für jeden Pin im Filter definieren. Wenn dieser Parameter vorhanden ist, muss er pinCount lang sein.
Rückgabewert
Gibt den Erfolg oder Fehler beim Erstellen des FilterData-Schlüssels in der Registrierung zurück.
Hinweise
Verwenden Sie KsRegisterFilterWithNoKSPins , um TvTuners, Crossbars und ähnliche Komponenten zu registrieren. KsRegisterFilterWithNoKSPins erstellt einen neuen Registrierungsschlüssel, FilterData, der die Medien und optional die Kategorien enthält, für jede Pin im Filter.
Diese Funktion wird nur verwendet, um Filter zu registrieren, die keine entsprechenden Kernel-Pins aufweisen. Bei erfolgreicher Ausführung erstellt KsRegisterFilterWithNoKSPins einen Schlüssel in der Registrierung, der dann von DirectShow verwendet werden kann.
Wenn Sie einen BDA-Minidriver schreiben, sollten Sie KsFilterFactoryUpdateCacheData anstelle dieser Routine verwenden. Weitere Informationen finden Sie auf der Referenzseite für KsFilterFactoryUpdateCacheData.
Weitere Informationen finden Sie unter AVStream-Deskriptoren und Initialisieren eines AVStream-Minidrivers.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |