Função BdaCreateFilterFactory (bdasup.h)

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 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.

Retornar valor

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Comentários

Um minidriver BDA chama a função BdaCreateFilterFactory 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:

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
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

Confira também

BDA_FILTER_TEMPLATE

BdaCreateFilterFactoryEx

KSDEVICE

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KSMETHODSETID_BdaChangeSync

KSMETHODSETID_BdaDeviceConfiguration

KSPROPSETID_BdaTopology