IOMMU_MAP_IDENTITY_RANGE_EX fungsi panggilan balik (wdm.h)

  • Artikel

Membuat pemetaan identitas untuk ruang alamat fisik yang disediakan di domain yang disediakan.

Sintaks

IOMMU_MAP_IDENTITY_RANGE_EX IommuMapIdentityRangeEx;

NTSTATUS IommuMapIdentityRangeEx(
  [in] PIOMMU_DMA_DOMAIN Domain,
  [in] ULONG Permissions,
  [in] PIOMMU_MAP_PHYSICAL_ADDRESS PhysicalAddressToMap
)
{...}

Parameter

[in] Domain

Penunjuk ke IOMMU_DMA_DOMAIN tempat alamat fisik yang dipetakan identitas. Domain harus berjenis DomainTypeTranslate atau DomainTypePassThrough. Untuk informasi selengkapnya tentang jenis domain, lihat IOMMU_DMA_DOMAIN_TYPE.

[in] Permissions

Bidang bit yang mewakili izin yang akan diatur untuk rentang yang sedang dipetakan. Lihat Keterangan untuk bit izin yang tersedia.

[in] PhysicalAddressToMap

IOMMU_MAP_PHYSICAL_ADDRESS yang akan dipetakan ke domain.

Nilai kembali

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

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER_1 Domain yang disediakan bukan berjenis DomainTypeTranslate atau DomainTypePassThrough.
STATUS_INVALID_PARAMETER_3 IOMMU_MAP_PHYSICAL_ADDRESS yang disediakan tidak mewakili memori fisik yang selaras dengan halaman dan memiliki ukuran yang merupakan kelipatan PAGE_SIZE.
STATUS_IN_USE Rentang identitas sudah dipetakan atau dipetakan sebagian.
STATUS_NOT_SUPPORTED Domain yang disediakan berisi alokator logis yang tidak mengizinkan alokasi alamat logis eksplisit.

Keterangan

Untuk membatalkan peta alamat logis yang dibuat oleh IOMMU_MAP_IDENTITY_RANGE_EX, gunakan IOMMU_UNMAP_IDENTITY_RANGE_EX.

Bidang izin adalah bitfield yang menjelaskan izin akses untuk halaman yang akan dipetakan.

Bit didefinisikan sebagai berikut:

Bit 0 = Read Access

Bit 1 = Write Access

Bits 31-2 = Reserved (0)

Persyaratan

Persyaratan Nilai
Server minimum yang didukung Windows Server 2022
Header wdm.h (termasuk Wdm.h)

Lihat juga

IOMMU_DMA_DOMAIN_TYPE

DMA_IOMMU_INTERFACE_V2

DMA_IOMMU_INTERFACE_EX

IOMMU_MAP_PHYSICAL_ADDRESS