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

Confira também

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KsRegisterFilterWithNoKSPins