Fungsi ZwUnmapViewOfSection (wdm.h)

  • Artikel

Rutinitas ZwUnmapViewOfSection membatalkan peta tampilan bagian dari ruang alamat virtual proses subjek.

Sintaks

NTSYSAPI NTSTATUS ZwUnmapViewOfSection(
  [in]           HANDLE ProcessHandle,
  [in, optional] PVOID  BaseAddress
);

Parameter

[in] ProcessHandle

Tangani ke objek proses yang sebelumnya diteruskan ke ZwMapViewOfSection.

[in, optional] BaseAddress

Arahkan ke alamat virtual dasar tampilan untuk membatalkan peta. Nilai ini bisa menjadi alamat virtual apa pun dalam tampilan.

Nilai kembali

ZwUnmapViewOfSection mengembalikan nilai NTSTATUS. Kemungkinan nilai yang dikembalikan meliputi:

Menampilkan kode Deskripsi
STATUS_SUCCESS Rutinitas berhasil melakukan operasi yang diminta.
STATUS_ACCESS_DENIED Pemanggil tidak memiliki hak akses ke objek proses atau ke alamat virtual dasar tampilan.

Keterangan

Rutinitas ini membatalkan peta seluruh tampilan bagian yang berisi BaseAddress dari ruang alamat virtual dari proses yang ditentukan—bahkan jika BaseAddress tidak menunjuk ke awal tampilan.

Saat kembali dari ZwUnmapViewOfSection, wilayah alamat virtual yang ditempati oleh tampilan tidak lagi dicadangkan dan tersedia untuk memetakan tampilan lain atau halaman privat. Jika tampilan juga merupakan referensi terakhir ke bagian yang mendasar, semua halaman yang diterapkan di bagian dinonaktifkan, dan bagian dihapus.

Jika panggilan ke fungsi ini terjadi dalam mode pengguna, Anda harus menggunakan nama "NtUnmapViewOfSection" alih-alih "ZwUnmapViewOfSection".

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinitas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menafsirkan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwMapViewOfSection

ZwOpenSection