Función BdaFilterFactoryUpdateCacheData (bdasup.h)

Artículo
08/07/2023

La función BdaFilterFactoryUpdateCacheData actualiza la caché de datos de anclaje para una instancia de un filtro.

Sintaxis

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

Parámetros

[in] pFilterFactory

Apunta al KSFILTERFACTORY para el que se va a actualizar la caché de datos de anclaje.

[in, optional] pFilterDescriptor

Apunta a un KSFILTER_DESCRIPTOR opcional para el que se actualizará la caché de datos de patillas. Si es NULL, se usa el descriptor de pFilterFactory en su lugar. Este parámetro habilita la creación de patillas dinámicas, es decir, la creación de patillas que se produce después de que se complete la rutina de distribución de creación de un filtro.

Valor devuelto

Devuelve STATUS_SUCCESS o un código de error adecuado. Devuelve STATUS_INVALID_PARAMETER si no se encuentra ninguna interfaz de dispositivo que corresponda a las categorías pasadas en el descriptor de filtro.

Comentarios

Un minidriver BDA llama a la función BdaFilterFactoryUpdateCacheData para actualizar la caché de datos de patillas para todos los pines especificados en pFilterDescriptor. En esta llamada, el minidriver BDA normalmente pasa el miembro pFilterDescriptor de una estructura BDA_FILTER_TEMPLATE que describe la topología de plantilla del filtro BDA a pFilterDescriptor. Si pFilterDescriptor es NULL, la información almacenada en caché se actualizará para todos los generadores de patillas especificados en el miembro KSFILTER_DESCRIPTOR de pFilterFactory. Para obtener información sobre la caché de datos de anclaje, consulte Almacenamiento en caché de información de patillas para DirectShow.

La función KsRegisterFilterWithNoKSPins proporciona una funcionalidad similar, pero solo permite un medio por patilla registrada. Esto puede no ser suficiente para un minidriver de BDA.