IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK回调函数 (wdm.h)

项目
03/05/2024

允许调用方注册每当发生与DMA_IOMMU_INTERFACE_EX相关的任何状态更改时要调用的回调。

语法

IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK IommuRegisterInterfaceStateChangeCallback;

NTSTATUS IommuRegisterInterfaceStateChangeCallback(
  PIOMMU_INTERFACE_STATE_CHANGE_CALLBACK StateChangeCallback,
  PVOID Context,
  PIOMMU_DMA_DEVICE DmaDevice,
  PIOMMU_INTERFACE_STATE_CHANGE_FIELDS StateFields
)
{...}

参数

StateChangeCallback

[In]要注册 IOMMU_INTERFACE_STATE_CHANGE_CALLBACK 。

Context

[In，可选]将传递给状态更改回调的可选上下文。

DmaDevice

[In]指向表示将链接到回调 的IOMMU_DMA_DEVICE 的不透明标记的指针。

StateFields

[In]指向调用方正在注册以接收通知的状态的指针。请参阅 IOMMU_INTERFACE_STATE_CHANGE_FIELDS。

返回值

如果操作成功，STATUS_SUCCESS。

可能的错误返回值包括以下状态代码。

返回代码	说明
STATUS_UNSUCCESSFUL	例程无法注册提供的回调，因为 IOMMU_DMA_DEVICE 已注册回叫。
STATUS_INVALID_PARAMETER_4	调用方未指示对中的任何 `StateFields`接口状态字段感兴趣。