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

[アーティクル]
03/05/2024

既存の DMA デバイスドメインに IOMMU_DMA_DEVICE をアタッチします。

構文

IOMMU_DOMAIN_ATTACH_DEVICE_EX IommuDomainAttachDeviceEx;

NTSTATUS IommuDomainAttachDeviceEx(
  PIOMMU_DMA_DOMAIN Domain,
  PIOMMU_DMA_DEVICE DmaDevice
)
{...}

パラメーター

Domain

[入力] IOMMU_DMA_DEVICE がアタッチするドメインへのハンドル。

DmaDevice

[入力]アタッチする IOMMU_DMA_DEVICE へのポインター。

戻り値

操作が成功した場合は、STATUS_SUCCESSします。エラーの戻り値として考えられるのは、次の状態コードです。

リターンコード	説明
STATUS_INSUFFICIENT_RESOURCES	ルーチンが必要なリソースを割り当てませんでした。
STATUS_INVALID_PARAMETER	デバイスは既にドメインに接続されています。
STATUS_ACCESS_DENIED	デバイスは現在、このドメインの種類にアタッチできません。

詳細については、「 NTSTATUS 値」を参照してください。

注釈

呼び出し元は、IOMMU_DMA_DEVICEを別のドメインにアタッチする前に、以前にアタッチされたドメインからIOMMU_DOMAIN_DETACH_DEVICE_EXを使用して最初にデタッチされるようにする必要があります。

ドライバーは、この関数が同じデバイス上の IOMMU_DOMAIN_DETACH_DEVICE_EX または IOMMU_SET_DEVICE_FAULT_REPORTING_EX 呼び出しと同時に呼び出されないようにする必要があります。

が返された場合 STATUS_ACCESS_DENIED は、現在、デバイスがアタッチできるドメインの種類が使用できない可能性があります。 IOMMU_DEVICE_QUERY_DOMAIN_TYPESを使用して、指定したデバイスで使用できるドメインの種類を確認することをお勧めします。使用可能な種類は、DMA Guard ポリシーとデバイスの特性によって異なる場合があります。ドメインの種類が使用可能な場合に通知を受け取る場合は、 IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK を使用して、使用可能なドメインの種類が変更されるたびに通知コールバックを登録することを検討してください。