Modul

  • Artikel

Gambar adalah executable, DLL, atau driver yang telah dimuat Windows sebagai bagian dari proses mode pengguna atau kernel. File tempat gambar dimuat disebut sebagai file gambarnya.

Mesin debugger menyimpan daftar modul untuk setiap proses (atau, dalam mode kernel, proses virtual). Biasanya setiap modul dalam daftar ini mewakili gambar dalam prosesnya. Daftar modul mesin dapat disinkronkan dengan target menggunakan Muat Ulang.

Catatan Dalam penelusuran kesalahan mode kernel, daftar modul mesin untuk proses virtual berisi modul mode kernel di seluruh sistem dan modul mode pengguna proses saat ini.

Modul dapat ditentukan oleh alamat dasarnya di ruang alamat virtual target, atau oleh indeksnya dalam daftar modul yang dikelola mesin untuk target. Indeks modul sama dengan posisinya dalam daftar modul, dan oleh karena itu indeks ini akan berubah jika modul dengan indeks yang lebih rendah dibongkar. Semua modul yang tidak dimuat memiliki indeks; ini selalu lebih tinggi dari indeks modul yang dimuat. Alamat dasar modul tidak akan berubah selama tetap dimuat; dalam beberapa kasus, modul dapat berubah jika modul dibongkar dan kemudian dimuat ulang.

Indeks adalah angka antara nol dan jumlah modul dalam target dikurangi satu. Jumlah modul dalam proses saat ini dapat ditemukan dengan memanggil GetNumberModules.

Indeks dapat digunakan untuk menemukan alamat dasar dengan memanggil GetModuleByIndex. Alamat dasar modul yang memiliki simbol dengan nama tertentu dapat ditemukan menggunakan GetSymbolModule.

Metode berikut mengembalikan indeks dan alamat dasar modul yang ditentukan:

  • Untuk menemukan modul dengan nama modul tertentu, gunakan GetModuleByModuleName.

  • Modul yang rentang alamat virtualnya berisi alamat tertentu dikembalikan oleh GetModuleByOffset. Metode ini dapat digunakan untuk menemukan indeks modul yang diberikan alamat dasar modul.

Metode berikut mengembalikan informasi tentang modul yang ditentukan baik berdasarkan alamat dasar atau indeks:

Modul yang Tidak Dimuat

Selama penelusuran kesalahan mode pengguna, modul yang dibongkar hanya dilacak di Windows Server 2003 dan versi Windows yang lebih baru. Versi Windows sebelumnya hanya melacak modul yang tidak dimuat dalam mode kernel. Ketika dilacak, modul diindeks setelah modul yang dimuat. Oleh karena itu, metode apa pun yang mencari modul target akan mencari semua modul yang dimuat dan kemudian modul yang dibongkar. Modul yang dibongkar dapat digunakan untuk menganalisis kegagalan yang disebabkan oleh upaya untuk memanggil kode yang tidak dimuat.

Modul Sintetis

Modul sintetis dapat dibuat sebagai cara untuk melabeli wilayah memori. Modul ini tidak boleh berisi simbol nyata, tetapi dapat berisi simbol sintetis. Metode AddSyntheticModule membuat modul sintetis baru. Modul sintetis dapat dihapus menggunakan RemoveSyntheticModule. Memuat ulang semua modul dalam target akan menghapus semua modul sintetis.

Jalur Gambar

Jalur gambar yang dapat dieksekusi digunakan oleh mesin saat mencari gambar yang dapat dieksekusi.

Jalur gambar yang dapat dieksekusi dapat terdiri dari beberapa direktori yang dipisahkan oleh titik koma (;). Direktori ini dicari secara berurutan.

Untuk gambaran umum jalur gambar yang dapat dieksekusi, lihat Jalur Gambar yang Dapat Dieksekusi.

Untuk menambahkan direktori ke jalur gambar yang dapat dieksekusi, gunakan metode AppendImagePath. Seluruh jalur gambar yang dapat dieksekusi dikembalikan oleh GetImagePath dan dapat diubah menggunakan SetImagePath.

Informasi Tambahan

Untuk informasi selengkapnya tentang proses dan proses virtual, lihat Utas dan Proses.