Función KsFilterFactoryUpdateCacheData (ks.h)

Artículo
03/08/2023

La función KsFilterFactoryUpdateCacheData actualiza la clave del Registro FilterData y la caché media (un conjunto de claves del Registro) para un generador de filtros determinado.

Sintaxis

KSDDKAPI NTSTATUS KsFilterFactoryUpdateCacheData(
  [in]           PKSFILTERFACTORY          FilterFactory,
  [in, optional] const KSFILTER_DESCRIPTOR *FilterDescriptor
);

Parámetros

[in] FilterFactory

KSFILTERFACTORY para el que se va a actualizar la memoria caché FilterData y Medium en el Registro.

[in, optional] FilterDescriptor

Una KSFILTER_DESCRIPTOR opcional para la que se actualizará la clave FilterData y la caché media. Si es NULL, se usa el descriptor de FilterFactory en su lugar. Proporcione si el generador de filtros usa patillas dinámicas y necesita actualizar la información de los patillas que aún no se han creado instancias.

Valor devuelto

KsFilterFactoryUpdateCacheData devuelve STATUS_SUCCESS o un código de error, lo que indica si la información del Registro pertinente se actualizó correctamente. 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

Esta función actualiza la clave FilterData y la caché media para todas las categorías especificadas en FilterDescriptor. Si FilterDescriptor es NULL, la caché FilterData y Medium se actualizan para todas las categorías especificadas en el miembro KSFILTER_DESCRIPTOR de FilterFactory.

KsRegisterFilterWithNoKSPins proporciona una funcionalidad similar, pero no se debe usar si dos instancias de KSFILTER_DESCRIPTOR en el mismo KSDEVICE se registran en la misma categoría y solo difieren en el GUID de referencia. En este caso, KsRegisterFilterWithNoKSPins actualiza los datos solo para el primero, aunque se haya especificado el segundo.

No use esta rutina en lugar de KsRegisterFilterWithNoKSPins para filtros sin patillas KS, como barras cruzadas de estilo analógico. Use esta rutina solo para un filtro específico para el que el minidriver pase el generador de filtros correspondiente.

Además, KsRegisterFilterWithNoKSPins solo permite un medio por patilla registrada. Esto puede no ser suficiente para un minidriver de BDA.

Para obtener más información, vea Jerarquía de objetos AVStream.

La función KsFilterFactoryUpdateCacheData solo se puede llamar en PASSIVE_LEVEL.