Função BdaInitFilter (bdasup.h)
A função BdaInitFilter inicializa o contexto de filtro BDA associado a uma instância de filtro.
Sintaxe
NTSTATUS BdaInitFilter(
[in] PKSFILTER pKSFilter,
[in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);
Parâmetros
[in] pKSFilter
Aponta para o filtro no qual inicializar o contexto de filtro BDA.
[in] pBdaFilterTemplate
Aponta para uma estrutura BDA_FILTER_TEMPLATE que descreve o modelo de filtro para o dispositivo BDA. Para determinar a topologia e configurar o filtro inicializado, o provedor de rede usa informações referenciadas nesta estrutura BDA_FILTER_TEMPLATE.
Retornar valor
Retorna STATUS_SUCCESS ou um código de erro apropriado.
Comentários
Um minidriver BDA chama a função BdaInitFilter para inicializar uma instância de um filtro usando um modelo de filtro BDA específico e uma fábrica de filtros que foi criada anteriormente por meio de uma chamada para a função BdaCreateFilterFactory . O minidriver BDA pode usar posteriormente essa instância de filtro em chamadas para outras funções de suporte do BDA, como BdaCreatePin.
Quando um minidriver BDA chama BdaInitFilter, o driver de suporte do BDA (Bdasup.sys) cria seu próprio contexto de filtro BDA. Esse contexto de filtro BDA está oculto do minidriver BDA. No entanto, quando necessário, o driver de suporte do BDA pode acessar esse contexto de filtro BDA. O driver de suporte do BDA adiciona um ponteiro a esse contexto de filtro BDA ao recipiente de objetos do objeto KSFILTER associado. Quando o objeto KSFILTER associado é destruído, o AVStream solicita que o driver de suporte do BDA exclua esse contexto de filtro BDA do recipiente de objetos. Dessa forma, o driver de suporte do BDA pode destruir esse contexto de filtro BDA sem a necessidade de intervenção do minidriver BDA.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores. Essa rotina estará disponível na plataforma Windows 2000 somente se o Microsoft DirectX 9.0 e posterior estiver instalado nessa plataforma. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | bdasup.h (inclua Bdasup.h) |
| Biblioteca | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |