Metode IDebugEventCallbacks::LoadModule (dbgeng.h)

Artikel
02/23/2024

Metode panggilan balik LoadModule dipanggil oleh mesin ketika peristiwa debugging beban modul terjadi di target.

Sintaks

HRESULT LoadModule(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCSTR   ModuleName,
  [in, optional] PCSTR   ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp
);

Parameter

[in] ImageFileHandle

Menentukan handel ke file gambar modul. Jika informasi ini tidak tersedia, ImageFileHandle akan menjadi NULL.

[in] BaseOffset

Menentukan alamat dasar modul di ruang alamat memori target. Jika informasi ini tidak tersedia, BaseOffset akan menjadi NULL.

[in] ModuleSize

Menentukan ukuran gambar modul dalam byte. Jika informasi ini tidak tersedia, ModuleSize akan null.

[in, optional] ModuleName

Menentukan nama modul yang disederhanakan yang digunakan oleh mesin debugger. Dalam kebanyakan kasus, ini cocok dengan nama file gambar yang tidak termasuk ekstensi. Jika informasi ini tidak tersedia, ModuleName akan menjadi NULL.

[in, optional] ImageName

Menentukan nama file gambar modul, yang dapat menyertakan jalur. Jika informasi ini tidak tersedia, ImageName akan menjadi NULL.

[in] CheckSum

Menentukan checksum file gambar modul. Jika informasi ini tidak tersedia, CheckSum akan menjadi NULL.

[in] TimeDateStamp

Menentukan stempel waktu dan tanggal file gambar modul. Jika informasi ini tidak tersedia, TimeDateStamp akan menjadi nol.

Nilai kembali

Metode ini mengembalikan nilai DEBUG_STATUS_XXX , yang menunjukkan bagaimana eksekusi target harus dilanjutkan setelah mesin memproses peristiwa ini. Untuk detail tentang cara mesin memperlakukan nilai ini, lihat Memantau Peristiwa.

Keterangan

Metode ini hanya dipanggil oleh mesin jika bendera DEBUG_EVENT_LOAD_MODULE diatur dalam masker yang dikembalikan oleh IDebugEventCallbacks::GetInterestMask.

Setelah memanggil metode ini, mesin akan memanggil IDebugEventCallbacks::ChangeSymbolState, dengan parameter Bendera yang berisi bendera bit DEBUG_CSS_LOADS.

Untuk informasi selengkapnya tentang menangani peristiwa, lihat Memantau Peristiwa.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	dbgeng.h (termasuk Dbgeng.h)