Função BdaFilterFactoryUpdateCacheData (bdasup.h)
A função BdaFilterFactoryUpdateCacheData atualiza o cache de dados de pin 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 fixação será atualizado. Se NULL, descritor dopFilterFactory será usado. Esse parâmetro permite a criação de pin dinâmico, ou seja, a criação de pin que ocorre após a conclusão da rotina de expedição de criação de um filtro.
Valor de retorno
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.
Observações
Um minidriver BDA chama a função BdaFilterFactoryUpdateCacheData para atualizar o cache de dados de pino para todos os pinos especificados em pFilterDescriptor. Nesta chamada, o minidriver BDA normalmente passa o pFilterDescriptor membro 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 fixação, consulte Informações de Fixação de Cache do 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.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | bdasup.h (inclua Bdasup.h) |
| biblioteca | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |