Função BdaStartChanges (bdasup.h)

Artigo
02/22/2024

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 que a solicitação inicie as alterações. O minidriver BDA recebe esse IRP com a solicitação KSMETHOD_BDA_START_CHANGES .

Retornar valor

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Comentários

Um minidriver BDA chama a função BdaStartChanges para iniciar a configuração de novas alterações de topologia 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, minidrivers BDA que interceptam essa solicitação podem obter um ponteiro para o filtro BDA do IRP passado para que eles 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 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.