Funzione BdaGetChangeState (bdasup.h)

Articolo
02/06/2025

La funzione BdaGetChangeState restituisce lo stato di modifica corrente della topologia BDA.

Sintassi

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

Parametri

[in] pIrp

Punta all'IRP per la richiesta per ottenere lo stato di modifica corrente. Il minidriver BDA riceve questo IRP con la richiesta di KSMETHOD_BDA_GET_CHANGE_STATE.

[out, optional] pChangeState

Punta a una variabile che riceve lo stato di modifica corrente della topologia BDA. Lo stato di modifica BDA può essere uno dei valori seguenti dal tipo enumerato BDA_CHANGE_STATE:

Valore	Descrizione
BDA_CHANGES_COMPLETE	Le modifiche della topologia BDA sono state completate.
BDA_CHANGES_PENDING	Le modifiche della topologia BDA sono in sospeso.

Valore restituito

Restituisce STATUS_SUCCESS o un codice di errore appropriato.

Osservazioni

Un minidriver BDA chiama la funzione BdaGetChangeState per recuperare lo stato di modifica corrente della topologia BDA dopo che il minidriver riceve una richiesta KSMETHOD_BDA_GET_CHANGE_STATE del metodo KSMETHODSETID_BdaChangeSync impostato dal provider di rete. I minidriver BDA definiscono tabelle dispatch e di automazione dei filtri in modo che tali minidriver inviino direttamente la funzione BdaGetChangeState BdaGetChangeState o intercettano questa richiesta usando un metodo interno (KStrMethodHandler), che chiama quindi la funzione BdaGetChangeState. Ad esempio, i minidriver BDA che intercettano questa richiesta possono ottenere un puntatore al filtro BDA dall'IRP passato in modo che possano:

Non solo controllare le modifiche della topologia in sospeso, ma anche le modifiche in sospeso nel filtro.
Restituisce lo stato di modifica corrente sia per la topologia BDA che per il filtro BDA.

Per altre informazioni, vedere Definizione di tabelle di automazione e modifica delle proprietà del filtro BDA.