Compartilhar via


Função BdaCommitChanges (bdasup.h)

A função BdaCommitChanges confirma as alterações na topologia do BDA que ocorreram desde a última chamada para a função BdaStartChanges.

Sintaxe

NTSTATUS BdaCommitChanges(
  [in] PIRP pIrp
);

Parâmetros

[in] pIrp

Aponta para o IRP para a solicitação de confirmação de alterações. O minidriver BDA recebe esse IRP com a solicitação KSMETHOD_BDA_COMMIT_CHANGES.

Valor de retorno

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Observações

Um minidriver BDA chama a função BdaCommitChanges para confirmar um conjunto de alterações de topologia do BDA depois que o minidriver recebe uma solicitação KSMETHOD_BDA_COMMIT_CHANGES do método KSMETHODSETID_BdaChangeSync definido do provedor de rede. Os minidrivers BDA definem tabelas de expedição e de automação de filtro para que esses minidrivers enviem a função BdaCommitChanges diretamente ou interceptem essa solicitação usando um método interno (KStrMethodHandler), que chama a função BdaCommitChanges. Por exemplo, os minidrivers BDA que interceptam essa solicitação podem obter um ponteiro para o filtro BDA do IRP passado para que eles possam:

  • Defina a nova lista de recursos para o filtro para a lista pendente de recursos.

  • Defina o estado de alteração do filtro como BDA_CHANGES_COMPLETE.

  • Confirme os recursos no dispositivo subjacente.

Consulte Definindo tabelas de automação e alterando as propriedades de filtro do BDA para obter mais informações.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Microsoft Windows XP e em sistemas operacionais posteriores.
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

BdaCheckChanges

BdaStartChanges

KSMETHODSETID_BdaChangeSync

KSMETHOD_BDA_COMMIT_CHANGES

KStrMethodHandler