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 |