Função BdaGetChangeState (bdasup.h)

Artigo
02/22/2024

A função BdaGetChangeState retorna o estado de alteração atual da topologia do BDA.

Sintaxe

NTSTATUS BdaGetChangeState(
  [in]            PIRP              pIrp,
  [out, optional] PBDA_CHANGE_STATE pChangeState
);

Parâmetros

[in] pIrp

Aponta para o IRP da solicitação para obter o estado de alteração atual. O minidriver BDA recebe esse IRP com a solicitação KSMETHOD_BDA_GET_CHANGE_STATE .

[out, optional] pChangeState

Aponta para uma variável que recebe o estado de alteração atual da topologia do BDA. O estado de alteração do BDA pode ser um dos seguintes valores do tipo enumerado BDA_CHANGE_STATE :

Valor	Descrição
BDA_CHANGES_COMPLETE	As alterações de topologia do BDA estão concluídas.
BDA_CHANGES_PENDING	As alterações de topologia do BDA estão pendentes.

Retornar valor

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Comentários

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

Não apenas marcar para alterações pendentes de topologia, mas também para alterações pendentes no filtro.
Retornar o estado de alteração atual para a topologia do BDA e o filtro BDA.

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