IOMMU_INTERFACE_STATE_CHANGE_CALLBACK función de devolución de llamada (wdm.h)

Artículo
03/05/2024

Esta rutina se invoca cada vez que se ha producido un cambio de estado del sistema que afecta a un DMA_IOMMU_INTERFACE_EX.

Sintaxis

IOMMU_INTERFACE_STATE_CHANGE_CALLBACK IommuInterfaceStateChangeCallback;

void IommuInterfaceStateChangeCallback(
  PIOMMU_INTERFACE_STATE_CHANGE StateChange,
  PVOID Context
)
{...}

Parámetros

StateChange

[In] Puntero a la información de estado que indica qué estados han cambiado. Consulte IOMMU_INTERFACE_STATE_CHANGE.

Context

[In, optional] Contexto opcional especificado por el llamador que coincide con el contexto opcional pasado al registrar una devolución de llamada de cambio de estado de la interfaz IOMMU a través de IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK.

Valor devuelto

None

Observaciones

Esta devolución de llamada debe registrarse a través de IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK. Se invocará inmediatamente tras el registro (para evitar condiciones de carrera) y cada vez que se haya producido un cambio de estado del sistema. El propietario de la devolución de llamada no debe asumir el estado y siempre debe comprobar la información de estado proporcionada en IOMMU_INTERFACE_STATE_CHANGE.

Es responsabilidad del propietario de la devolución de llamada anular el registro de la devolución de llamada, mediante IOMMU_UNREGISTER_INTERFACE_STATE_CHANGE_CALLBACK, antes de eliminar un DMA_IOMMU_INTERFACE_EX o IOMMU_DMA_DEVICE.