IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK コールバック関数 (wdm.h)

[アーティクル]
02/27/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

[入力]登録する IOMMU_INTERFACE_STATE_CHANGE_CALLBACK 。

Context

[入力、省略可能]状態変更コールバックに渡される省略可能なコンテキスト。

DmaDevice

[入力]コールバックにリンクされる IOMMU_DMA_DEVICE を表す不透明なトークンへのポインター。

StateFields

[入力]呼び出し元が通知を受け取るために登録している状態へのポインター。 「IOMMU_INTERFACE_STATE_CHANGE_FIELDS」を参照してください。

戻り値

操作が成功した場合は、STATUS_SUCCESSします。

エラーの戻り値として考えられるのは、次の状態コードです。

リターンコード	説明
STATUS_UNSUCCESSFUL	IOMMU_DMA_DEVICEが既にコールバックに登録されているため、ルーチンで指定されたコールバックを登録できませんでした。
STATUS_INVALID_PARAMETER_4	呼び出し元は、のインターフェイス状態フィールド `StateFields`に関心があることを示しませんでした。