Função KsFilterFactoryUpdateCacheData (ks.h)
A função KsFilterFactoryUpdateCacheData atualiza a chave do Registro FilterData e o cache Médio (um conjunto de chaves do Registro) para uma determinada fábrica de filtros.
Sintaxe
KSDDKAPI NTSTATUS KsFilterFactoryUpdateCacheData(
[in] PKSFILTERFACTORY FilterFactory,
[in, optional] const KSFILTER_DESCRIPTOR *FilterDescriptor
);
Parâmetros
[in] FilterFactory
O KSFILTERFACTORY para o qual atualizar FilterData e o cache Médio no registro.
[in, optional] FilterDescriptor
Um KSFILTER_DESCRIPTOR opcional para o qual a chave FilterData e o cache médio serão atualizados. Se NULL, descritorFilterFactory será usado. Forneça se a fábrica de filtros usa pinos dinâmicos e precisa atualizar informações para pinos que ainda não foram instanciados.
Valor de retorno
KsFilterFactoryUpdateCacheData retorna STATUS_SUCCESS ou um código de falha, indicando se as informações relevantes do Registro foram atualizadas com êxito. Ele retornará STATUS_INVALID_PARAMETER se nenhuma interface de dispositivo for encontrada que corresponda às categorias passadas no descritor de filtro.
Observações
Essa função atualiza a chave FilterData e o cache médio para todas as categorias especificadas em FilterDescriptor. Se FilterDescriptor for NULL, o cache FilterData e Medium será atualizado para todas as categorias especificadas no membro KSFILTER_DESCRIPTORFilterFactory.
KsRegisterFilterWithNoKSPins fornece funcionalidade semelhante, mas não deve ser usada se duas instâncias de KSFILTER_DESCRIPTOR no mesmo KSDEVICE forem registradas na mesma categoria e forem diferentes apenas no GUID de referência. Nesse caso, KsRegisterFilterWithNoKSPins atualiza os dados apenas para o primeiro, mesmo que o segundo possa ter sido especificado.
Não use essa rotina no lugar de KsRegisterFilterWithNoKSPins para filtros sem pinos KS, como barras cruzadas de estilo analógico. Use essa rotina apenas para um filtro específico para o qual o minidriver está passando a fábrica de filtros correspondente.
Além disso, KsRegisterFilterWithNoKSPins permite apenas uma média por pino registrado. Isso pode não ser suficiente para um minidriver BDA.
Para obter mais informações, consulte AVStream Object Hierarchy.
A função KsFilterFactoryUpdateCacheData só pode ser chamada em PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |