IOMMU_DOMAIN_ATTACH_DEVICE_EX fungsi panggilan balik (wdm.h)

Artikel
02/29/2024

Melampirkan IOMMU_DMA_DEVICE ke domain perangkat DMA yang sudah ada.

Sintaks

IOMMU_DOMAIN_ATTACH_DEVICE_EX IommuDomainAttachDeviceEx;

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

Parameter

Domain

[In] Handel ke domain yang akan dilampirkan IOMMU_DMA_DEVICE .

DmaDevice

[In] Penunjuk ke IOMMU_DMA_DEVICE yang akan dilampirkan.

Nilai kembali

STATUS_SUCCESS jika operasi berhasil. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.

Menampilkan kode	Deskripsi
STATUS_INSUFFICIENT_RESOURCES	Rutinitas gagal mengalokasikan sumber daya yang diperlukan.
STATUS_INVALID_PARAMETER	Perangkat sudah dilampirkan ke domain.
STATUS_ACCESS_DENIED	Perangkat saat ini tidak diizinkan untuk melampirkan ke tipe domain ini.

Untuk informasi selengkapnya, lihat Nilai NTSTATUS.

Keterangan

Pemanggil bertanggung jawab untuk memastikan bahwa IOMMU_DMA_DEVICE pertama kali dilepas, menggunakan IOMMU_DOMAIN_DETACH_DEVICE_EX, dari domain yang dilampirkan sebelumnya sebelum mencoba melampirkannya ke domain lain.

Merupakan tanggung jawab driver untuk memastikan bahwa fungsi ini tidak dipanggil bersamaan dengan panggilan IOMMU_DOMAIN_DETACH_DEVICE_EX atau IOMMU_SET_DEVICE_FAULT_REPORTING_EX pada perangkat yang sama.

Jika STATUS_ACCESS_DENIED dikembalikan, kemungkinan jenis domain saat ini tidak tersedia untuk dilampirkan oleh perangkat. Disarankan untuk menggunakan IOMMU_DEVICE_QUERY_DOMAIN_TYPES untuk menentukan jenis domain apa yang tersedia untuk perangkat yang ditentukan. Jenis yang tersedia dapat bervariasi tergantung pada kebijakan DMA Guard dan karakteristik perangkat. Untuk diberi tahu tentang kapan jenis domain tersedia, pertimbangkan untuk menggunakan IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK untuk mendaftarkan panggilan balik pemberitahuan setiap kali jenis domain yang tersedia berubah.