Partilhar via


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

Consulte também

BDA_CHANGE_STATE

BdaCommitChanges

KSMETHODSETID_BdaChangeSync

KSMETHOD_BDA_START_CHANGES

KStrMethodHandler