Função BdaStartChanges (bdasup.h)
A função BdaStartChanges inicia a configuração de novas alterações de topologia do BDA.
Sintaxe
NTSTATUS BdaStartChanges(
[in] PIRP pIrp
);
Parâmetros
[in] pIrp
Aponta para o IRP para a solicitação para iniciar alterações. O minidriver BDA recebe esse IRP com a solicitação KSMETHOD_BDA_START_CHANGES.
Valor de retorno
Retorna STATUS_SUCCESS ou um código de erro apropriado.
Observações
Um minidriver BDA chama a função BdaStartChanges para iniciar a configuração de novas alterações de topologia do BDA depois que o minidriver recebe uma solicitação KSMETHOD_BDA_START_CHANGES do método KSMETHODSETID_BdaChangeSync definido do provedor de rede. Os minidrivers BDA definem tabelas de expedição e automação de filtro para que esses minidrivers enviem a função BdaStartChanges diretamente ou interceptem essa solicitação usando um método interno (KStrMethodHandler), que chama a função BdaStartChanges. Por exemplo, os minidrivers BDA que interceptam essa solicitação podem obter um ponteiro para o filtro BDA do IRP passado para que possam redefinir posteriormente os recursos de filtro pendentes para os novos requisitos e definir o estado de alteração do filtro como BDA_CHANGES_COMPLETE. Consulte Definindo tabelas de automação e alterando as propriedades de filtro do BDA para obter mais informações.
Chamar a função BdaStartChanges faz com que quaisquer alterações de topologia solicitadas anteriormente que ainda não tenham sido confirmadas sejam ignoradas.
Requisitos
Requisito | Valor |
---|---|
da Plataforma de Destino | Área de trabalho |
cabeçalho | bdasup.h (inclua Bdasup.h) |
biblioteca | Bdasup.lib |
IRQL | PASSIVE_LEVEL |