KsFilterFactoryUpdateCacheData-Funktion (ks.h)

Artikel
02/26/2024

Die KsFilterFactoryUpdateCacheData-Funktion aktualisiert den Registrierungsschlüssel FilterData und den Mittleren Cache (eine Gruppe 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 Medium-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 der Deskriptor von FilterFactory 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. Es wird STATUS_INVALID_PARAMETER zurückgegeben, wenn keine Geräteschnittstelle gefunden wird, die den im Filterdeskriptor übergebenen Kategorien entspricht.

Hinweise

Diese Funktion aktualisiert den FilterData-Schlüssel und den mittleren Cache für alle kategorien, die in FilterDescriptor angegeben sind. Wenn FilterDescriptorNULL ist, werden der FilterData- und der Mittlere Cache für alle Kategorien aktualisiert, die im KSFILTER_DESCRIPTOR Element von FilterFactory angegeben sind.

KsRegisterFilterWithNoKSPins bietet ähnliche Funktionen, sollte aber nicht verwendet werden, wenn zwei Instanzen von KSFILTER_DESCRIPTOR unter demselben KSDEVICE in derselben Kategorie registriert sind und sich nur in der Referenz-GUID unterscheiden. In diesem Fall aktualisiert KsRegisterFilterWithNoKSPins die Daten nur für die erste, auch wenn die zweite angegeben wurde.

Verwenden Sie diese Routine nicht anstelle von KsRegisterFilterWithNoKSPins für Filter ohne KS-Pins, z. B. Querleisten im analogen Stil. Verwenden Sie diese Routine nur für einen bestimmten Filter, für den der Minitreiber die entsprechende Filterfactory übergibt.

Darüber hinaus lässt KsRegisterFilterWithNoKSPins nur ein Medium pro registrierter Pin zu. Dies ist für einen BDA-Minitreiber möglicherweise nicht ausreichend.

Weitere Informationen finden Sie unter AVStream-Objekthierarchie.

Die KsFilterFactoryUpdateCacheData-Funktion kann nur in PASSIVE_LEVEL aufgerufen werden.