Funzione BdaGetChangeState (bdasup.h)

Articolo
02/25/2024

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 l'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 complete.
BDA_CHANGES_PENDING	Le modifiche della topologia BDA sono in sospeso.

Valore restituito

Restituisce STATUS_SUCCESS o un codice di errore appropriato.

Commenti

Un minidriver BDA chiama la funzione BdaGetChangeState per recuperare lo stato di modifica corrente della topologia BDA dopo che il minidriver riceve una richiesta di KSMETHOD_BDA_GET_CHANGE_STATE del metodo KSMETHODSETID_BdaChangeSync impostato dal provider di rete. I minidriver BDA definiscono tabelle di invio e automazione filtro in modo che tali minidriver inviino la funzione BdaGetChangeState direttamente 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 verificare le modifiche alla topologia in sospeso, ma anche per le modifiche in sospeso nel filtro.
Restituisce lo stato di modifica corrente per la topologia BDA e il filtro BDA.

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