Función BdaGetChangeState (bdasup.h)

Artículo
02/22/2024

La función BdaGetChangeState devuelve el estado de cambio actual de la topología de BDA.

Sintaxis

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

Parámetros

[in] pIrp

Apunta al IRP de la solicitud para obtener el estado de cambio actual. El minidriver BDA recibe este IRP con la solicitud de KSMETHOD_BDA_GET_CHANGE_STATE .

[out, optional] pChangeState

Apunta a una variable que recibe el estado de cambio actual de la topología de BDA. El estado de cambio de BDA puede ser uno de los siguientes valores del BDA_CHANGE_STATE tipo enumerado:

Valor	Descripción
BDA_CHANGES_COMPLETE	Se han completado los cambios de topología de BDA.
BDA_CHANGES_PENDING	Los cambios en la topología de BDA están pendientes.

Valor devuelto

Devuelve STATUS_SUCCESS o un código de error adecuado.

Comentarios

Un minidriver BDA llama a la función BdaGetChangeState para recuperar el estado de cambio actual de la topología de BDA después de que el minidriver reciba una solicitud KSMETHOD_BDA_GET_CHANGE_STATE del método KSMETHODSETID_BdaChangeSync establecido desde el proveedor de red. Los minidrivers de BDA definen tablas de distribución y automatización de filtros para que esos minidrivers envíen la función BdaGetChangeState directamente o intercepten esta solicitud mediante un método interno (KStrMethodHandler), que luego llama a la función BdaGetChangeState . Por ejemplo, los minidrivers de BDA que interceptan esta solicitud pueden obtener un puntero al filtro BDA del IRP pasado para que puedan:

No solo comprueba si hay cambios pendientes de topología, sino también para los cambios pendientes en el filtro.
Devuelve el estado de cambio actual para la topología BDA y el filtro BDA.

Consulte Definición de tablas de automatización y Cambio de las propiedades de filtro BDA para obtener más información.