BdaFilterFactoryUpdateCacheData-Funktion (bdasup.h)

Artikel
02/22/2024

Die Funktion BdaFilterFactoryUpdateCacheData aktualisiert den Pindatencache für eine instance eines Filters.

Syntax

NTSTATUS BdaFilterFactoryUpdateCacheData(
  [in]           PKSFILTERFACTORY          pFilterFactory,
  [in, optional] const KSFILTER_DESCRIPTOR *pFilterDescriptor
);

Parameter

[in] pFilterFactory

Verweist auf die KSFILTERFACTORY , für die der Pindatencache aktualisiert werden soll.

[in, optional] pFilterDescriptor

Verweist auf eine optionale KSFILTER_DESCRIPTOR , für die der Pindatencache aktualisiert wird. Wenn NULL, wird stattdessen der Deskriptor von pFilterFactory verwendet. Dieser Parameter ermöglicht die dynamische Pinerstellung, d. h. die Pinerstellung, die nach Abschluss der Create Dispatch-Routine eines Filters erfolgt.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück. Gibt STATUS_INVALID_PARAMETER zurück, wenn keine Geräteschnittstelle gefunden wird, die den im Filterdeskriptor übergebenen Kategorien entspricht.

Hinweise

Ein BDA-Minidriver ruft die BdaFilterFactoryUpdateCacheData-Funktion auf, um den Pindatencache für alle unter pFilterDescriptor angegebenen Pins zu aktualisieren. Bei diesem Aufruf übergibt der BDA-Minidriver in der Regel den pFilterDescriptor-Member einer BDA_FILTER_TEMPLATE-Struktur , die die Vorlagentopologie für den BDA-Filter beschreibt, an pFilterDescriptor. Wenn pFilterDescriptorNULL ist, werden die zwischengespeicherten Informationen für alle Pinfactorys aktualisiert, die im KSFILTER_DESCRIPTOR-Member von pFilterFactory angegeben sind. Informationen zum Pindatencache finden Sie unter Zwischenspeichern von Pininformationen für DirectShow.

Die KsRegisterFilterWithNoKSPins-Funktion bietet ähnliche Funktionen, lässt jedoch nur ein Medium pro registrierter Pin zu. Dies ist für einen BDA-Minitreiber möglicherweise nicht ausreichend.