Função BdaCreateFilterFactory (bdasup.h)

Artigo
02/06/2025

A função BdaCreateFilterFactory adiciona o descritor de filtro especificado como uma fábrica de filtros ao dispositivo especificado e associa a fábrica de filtros à topologia de modelo BDA especificada.

Sintaxe

NTSTATUS BdaCreateFilterFactory(
  [in] PKSDEVICE                 pKSDevice,
  [in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

Parâmetros

[in] pKSDevice

Aponta para o dispositivo BDA ao qual adicionar a fábrica de filtros à topologia de modelo BDA associada.

[in] pFilterDescriptor

Aponta para uma estrutura KSFILTER_DESCRIPTOR que descreve um filtro para o dispositivo BDA. Observe que nem todos os tipos de pin e nó de modelo podem ser expostos como fábricas de pinos e nós quando o filtro é inicializado pela primeira vez.

[in] pBdaFilterTemplate

Aponta para uma estrutura de BDA_FILTER_TEMPLATE que descreve uma topologia de modelo BDA.

Valor de retorno

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Observações

Um minidriver BDA chama a função BdaCreateFilterFactory para adicionar uma fábrica de filtros a uma topologia de modelo BDA associada a um dispositivo e registrar todas as estruturas de modelo estático da topologia com a biblioteca de suporte do BDA (BdaSup.sys). A biblioteca de suporte do BDA pode manipular o seguinte método e chamadas de propriedade:

Se um minidriver BDA exigir um ponteiro para a fábrica de filtros recém-criada (KSFILTERFACTORY), o minidriver deverá chamar a função BdaCreateFilterFactoryEx.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Microsoft Windows XP e em sistemas operacionais posteriores.
da Plataforma de Destino	Área de trabalho
cabeçalho	bdasup.h (inclua Bdasup.h)
biblioteca	Bdasup.lib
IRQL	PASSIVE_LEVEL