Funzione BdaStartChanges (bdasup.h)

Articolo
02/26/2024

La funzione BdaStartChanges avvia l'impostazione delle nuove modifiche della topologia BDA.

Sintassi

NTSTATUS BdaStartChanges(
  [in] PIRP pIrp
);

Parametri

[in] pIrp

Punta all'IRP per la richiesta di avvio delle modifiche. Il minidriver BDA riceve l'IRP con la richiesta di KSMETHOD_BDA_START_CHANGES .

Valore restituito

Restituisce STATUS_SUCCESS o un codice di errore appropriato.

Commenti

Un minidriver BDA chiama la funzione BdaStartChanges per avviare l'impostazione della nuova topologia BDA dopo che il minidriver riceve una richiesta di KSMETHOD_BDA_START_CHANGES 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 BdaStartChanges direttamente o intercettano questa richiesta usando un metodo interno (KStrMethodHandler), che chiama quindi la funzione BdaStartChanges . Ad esempio, i minidriver BDA che intercettano questa richiesta possono ottenere un puntatore al filtro BDA dall'IRP passato in modo che possano successivamente reimpostare le risorse di filtro in sospeso ai nuovi requisiti e impostare lo stato di modifica del filtro su BDA_CHANGES_COMPLETE. Per altre informazioni, vedere Definizione di tabelle di automazione e modifica delle proprietà del filtro BDA .

La chiamata alla funzione BdaStartChanges causa l'ignorare qualsiasi modifica della topologia richiesta in precedenza non ancora eseguita.