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 Medium cache no registro.
[in, optional] FilterDescriptor
Um KSFILTER_DESCRIPTOR opcional para o qual a chave FilterData e o cache Médio serão atualizados. Se FOR NULL, o descritor de FilterFactory 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.
Retornar valor
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.
Comentários
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_DESCRIPTOR do FilterFactory.
KsRegisterFilterWithNoKSPins fornece funcionalidade semelhante, mas não deve ser usado se duas instâncias de KSFILTER_DESCRIPTOR na mesma KSDEVICE forem registradas na mesma categoria e diferem apenas no GUID de referência. Nesse caso, KsRegisterFilterWithNoKSPins atualiza 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 um pino médio por registrado. Isso pode não ser suficiente para um minidriver BDA.
Para obter mais informações, consulte Hierarquia de objetos AVStream.
A função KsFilterFactoryUpdateCacheData só pode ser chamada em PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |