Função BdaFilterFactoryUpdateCacheData (bdasup.h)

Artigo
02/22/2024

A função BdaFilterFactoryUpdateCacheData atualiza o cache de dados de pino para uma instância de um filtro.

Sintaxe

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

Parâmetros

[in] pFilterFactory

Aponta para o KSFILTERFACTORY para o qual atualizar o cache de dados de fixação.

[in, optional] pFilterDescriptor

Aponta para um KSFILTER_DESCRIPTOR opcional para o qual o cache de dados de pino será atualizado. Se FOR NULL, o descritor de pFilterFactory será usado. Esse parâmetro permite a criação dinâmica de pinos, ou seja, a criação de pinos que ocorre após a conclusão da rotina de expedição de criação de um filtro.

Retornar valor

Retorna STATUS_SUCCESS ou um código de erro apropriado. Retorna STATUS_INVALID_PARAMETER se nenhuma interface de dispositivo for encontrada que corresponda às categorias passadas no descritor de filtro.

Comentários

Um minidriver BDA chama a função BdaFilterFactoryUpdateCacheData para atualizar o cache de dados de pino para todos os pinos especificados em pFilterDescriptor. Nessa chamada, o minidriver BDA normalmente passa o membro pFilterDescriptor de uma estrutura BDA_FILTER_TEMPLATE que descreve a topologia de modelo do filtro BDA para pFilterDescriptor. Se pFilterDescriptor for NULL, as informações armazenadas em cache serão atualizadas para todas as fábricas de pinos especificadas no membro KSFILTER_DESCRIPTOR do pFilterFactory. Para obter informações sobre o cache de dados de pino, consulte Informações de fixação em cache para DirectShow.

A função KsRegisterFilterWithNoKSPins fornece funcionalidade semelhante, mas permite apenas um pino médio por registrado. Isso pode não ser suficiente para um minidriver BDA.