IOMMU_DOMAIN_ATTACH_DEVICE fungsi panggilan balik (wdm.h)

  • Artikel

Melampirkan perangkat ke domain yang sudah ada.

Sintaks

IOMMU_DOMAIN_ATTACH_DEVICE IommuDomainAttachDevice;

NTSTATUS IommuDomainAttachDevice(
  [_In_] PIOMMU_DMA_DOMAIN Domain,
  [_In_] PDEVICE_OBJECT PhysicalDeviceObject,
  [_In_] ULONG InputMappingIdBase,
  [_In_] ULONG MappingCount
)
{...}

Parameter

[_In_] Domain

Penunjuk ke handel ke domain.

[_In_] PhysicalDeviceObject

Pointer objek perangkat fisik (PDO) di tumpukan perangkat perangkat.

[_In_] InputMappingIdBase

Basis pemetaan input untuk aliran yang diinginkan perangkat.

[_In_] MappingCount

Jumlah pemetaan dimulai dari dasar.

Nilai kembali

Mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, kembalikan kode kesalahan nilai NTSTATUS yang sesuai. Untuk informasi selengkapnya, lihat Nilai NTSTATUS.

Keterangan

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

InputMappingIdBase dan MappingCount hanya dimaksudkan untuk mengakomodasi perangkat berukuran ACPI yang mendukung beberapa ID aliran di ARM64. Untuk perangkat atau arsitektur lainnya, nilai-nilai ini harus:

  • InputMappingIdBase = 0

  • MappingCount = 1

Layanan ini tidak digunakan lagi. Pertimbangkan untuk menggunakan IOMMU_DOMAIN_ATTACH_DEVICE_EX dan DMA_IOMMU_INTERFACE_EX.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10 versi 1803
Header wdm.h (termasuk Wdm.h)