BdaFilterFactoryUpdateCacheData-Funktion (bdasup.h)

2025-02-06

Die BdaFilterFactoryUpdateCacheData--Funktion aktualisiert den Pindatencache für eine Instanz 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 pFilterFactory's Deskriptor verwendet. Dieser Parameter ermöglicht die dynamische Pinerstellung, d. h. die Pinerstellung, die nach Abschluss der Erstellungsroutine eines Filters auftritt.

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.

Bemerkungen

Ein BDA-Minidriver ruft die BdaFilterFactoryUpdateCacheData--Funktion auf, um den Pindatencache für alle Pins zu aktualisieren, die an pFilterDescriptor-angegeben sind. In 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 an pFilterDescriptorbeschreibt. Wenn pFilterDescriptor-NULL-ist, werden die zwischengespeicherten Informationen für alle Pin-Fabriken aktualisiert, die bei pFilterFactoryKSFILTER_DESCRIPTOR Member angegeben sind. Informationen zum Pindatencache finden Sie unter Zwischenspeichern von Pininformationen für DirectShow-.

Die KsRegisterFilterWithNoKSPins--Funktion bietet ähnliche Funktionen, ermöglicht jedoch nur ein Medium pro registrierter Pin. Dies reicht möglicherweise nicht für einen BDA-Minidriver aus.