IOMMU_INTERFACE_STATE_CHANGE_CALLBACK função de retorno de chamada (wdm.h)

Artigo
03/01/2024

Essa rotina é invocada sempre que há uma alteração de estado do sistema que afeta um DMA_IOMMU_INTERFACE_EX.

Sintaxe

IOMMU_INTERFACE_STATE_CHANGE_CALLBACK IommuInterfaceStateChangeCallback;

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

Parâmetros

StateChange

[In] Um ponteiro para as informações de estado que indica quais estados foram alterados. Confira IOMMU_INTERFACE_STATE_CHANGE.

Context

[In, opcional] Um contexto opcional especificado pelo chamador que corresponde ao contexto opcional passado ao registrar um retorno de chamada de alteração de estado da Interface IOMMU por meio de IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK.

Retornar valor

Nenhum

Comentários

Esse retorno de chamada deve ser registrado por meio de IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK. Ele será invocado imediatamente após o registro (para evitar condições de corrida) e sempre que uma alteração de estado do sistema ocorrer. O proprietário do retorno de chamada não deve assumir o estado e deve sempre marcar as informações de estado fornecidas no IOMMU_INTERFACE_STATE_CHANGE.

É responsabilidade do proprietário do retorno de chamada cancelar o registro do retorno de chamada, usando IOMMU_UNREGISTER_INTERFACE_STATE_CHANGE_CALLBACK, antes de descartar um DMA_IOMMU_INTERFACE_EX ou IOMMU_DMA_DEVICE.