Função BdaCreateFilterFactoryEx (bdasup.h)

Artigo
02/22/2024

A função BdaCreateFilterFactoryEx 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 BdaCreateFilterFactoryEx(
  [in]            PKSDEVICE                 pKSDevice,
  [in]            const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in]            const BDA_FILTER_TEMPLATE *pBdaFilterTemplate,
  [out, optional] PKSFILTERFACTORY          *ppKSFilterFactory
);

Parâmetros

[in] pKSDevice

Aponta para o dispositivo BDA ao qual adicionar a fábrica de filtros com a 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 pino 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 BDA_FILTER_TEMPLATE que descreve uma topologia de modelo BDA.

[out, optional] ppKSFilterFactory

Aponta para um buffer que recebe um ponteiro para uma estrutura KSFILTERFACTORY para a fábrica de filtros recém-criada.

Retornar valor

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Comentários

Um minidriver BDA chama a função BdaCreateFilterFactoryEx para adicionar uma fábrica de filtros com 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:

Um minidriver BDA chama BdaCreateFilterFactoryEx em vez da função BdaCreateFilterFactory sempre que requer um ponteiro para o KSFILTERFACTORY recém-criado. A função BdaCreateFilterFactory também cria uma fábrica de filtros, mas não a retorna ao chamador. O minidriver BDA exigirá um ponteiro para o KSFILTERFACTORY recém-criado se o minidriver precisar chamar a função _KsEdit para editar KSFILTERFACTORY.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Microsoft Windows XP e em sistemas operacionais posteriores.
Plataforma de Destino	Área de Trabalho
Cabeçalho	bdasup.h (inclua Bdasup.h)
Biblioteca	Bdasup.lib
IRQL	PASSIVE_LEVEL