KsFilterFactoryUpdateCacheData-Funktion (ks.h)
Die Funktion KsFilterFactoryUpdateCacheData aktualisiert den FilterData-Registrierungsschlüssel und den mittleren Cache (eine Reihe von Registrierungsschlüsseln) für eine bestimmte Filterfactory.
Syntax
KSDDKAPI NTSTATUS KsFilterFactoryUpdateCacheData(
[in] PKSFILTERFACTORY FilterFactory,
[in, optional] const KSFILTER_DESCRIPTOR *FilterDescriptor
);
Parameter
[in] FilterFactory
Die KSFILTERFACTORY-, für die FilterData und mittlerer Cache in der Registrierung aktualisiert werden sollen.
[in, optional] FilterDescriptor
Eine optionale KSFILTER_DESCRIPTOR, für die der FilterData-Schlüssel und der mittlere Cache aktualisiert werden. Wenn NULL-, wird stattdessen FilterFactory's Deskriptor verwendet. Geben Sie an, ob die Filterfactory dynamische Pins verwendet und Informationen für Pins aktualisieren muss, die noch nicht instanziiert wurden.
Rückgabewert
KsFilterFactoryUpdateCacheData gibt STATUS_SUCCESS oder einen Fehlercode zurück, der angibt, ob die relevanten Registrierungsinformationen erfolgreich aktualisiert wurden. Sie gibt STATUS_INVALID_PARAMETER zurück, wenn keine Geräteschnittstelle gefunden wird, die den im Filterdeskriptor übergebenen Kategorien entspricht.
Bemerkungen
Diese Funktion aktualisiert den FilterData-Schlüssel und den mittleren Cache für alle Kategorien, die in FilterDescriptor-angegeben sind. Wenn FilterDescriptor-NULL-ist, werden der FilterData- und der mittlere Cache für alle Kategorien aktualisiert, die in FilterFactory'KSFILTER_DESCRIPTOR Member' angegeben sind.
KsRegisterFilterWithNoKSPins bietet ähnliche Funktionen, sollte jedoch nicht verwendet werden, wenn zwei Instanzen von KSFILTER_DESCRIPTOR unter demselben KSDEVICE- in derselben Kategorie registriert sind und sich nur in Referenz-GUID unterscheiden. In diesem Fall aktualisiert KsRegisterFilterWithNoKSPins daten nur für den ersten, auch wenn die zweite angegeben wurde.
Verwenden Sie diese Routine nicht anstelle von KsRegisterFilterWithNoKSPins für Filter ohne KS-Pins, wie z. B. Analogformat-Kreuzleisten.Do not use this routine in place of KsRegisterFilterWithNoKSPins for filters with no KS pins, such as analog style crossbars. Verwenden Sie diese Routine nur für einen bestimmten Filter, für den der Minidriver die entsprechende Filterfactory übergibt.
Darüber hinaus erlaubt KsRegisterFilterWithNoKSPins nur ein Medium pro registrierter Pin. Dies reicht möglicherweise nicht für einen BDA-Minidriver aus.
Weitere Informationen finden Sie unter AVStream-Objekthierarchie.
Die Funktion KsFilterFactoryUpdateCacheData kann nur in PASSIVE_LEVEL aufgerufen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |