Metode IDebugDataSpaces4::GetOffsetInformation (dbgeng.h)

Artikel
02/23/2024

Metode GetOffsetInformation menyediakan informasi umum tentang alamat dalam ruang data proses.

Sintaks

HRESULT GetOffsetInformation(
  [in]            ULONG   Space,
  [in]            ULONG   Which,
  [in]            ULONG64 Offset,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Parameter

[in] Space

Menentukan ruang data tempat parameter Offset diterapkan. Nilai yang diizinkan bergantung pada parameter Mana .

[in] Which

Menentukan informasi mana tentang data yang sedang dikueri. Ini menentukan nilai yang mungkin untuk Spasi dan jenis data yang dikembalikan di Buffer. Potensi nilai:

DEBUG_OFFSINFO_VIRTUAL_SOURCE

Mengembalikan sumber memori virtual target di Offset. Di sinilah mesin debugger membaca memori. Spasi harus diatur ke DEBUG_DATA_SPACE_VIRTUAL. ULONG dikembalikan ke Buffer. ULONG ini dapat mengambil nilai yang tercantum dalam tabel berikut.

Nilai	Deskripsi
DEBUG_VSOURCE_INVALID	Offset Offset tidak tersedia di ruang alamat virtual proses. Ini bisa berarti bahwa alamat tidak valid, atau bahwa memori tidak tersedia -- misalnya, file crash-dump mungkin tidak berisi semua memori untuk proses atau untuk kernel.
DEBUG_VSOURCE_DEBUGGEE	Memori virtual di offset Offset disediakan oleh target.
DEBUG_VSOURCE_MAPPED_IMAGE	Mesin debugger membaca memori virtual target di Offset offset dari file gambar lokal. Ini sering terjadi dalam file minidump di mana gambar modul tidak disertakan dalam file cadangan dan sebaliknya dimuat oleh mesin debugger.

[in] Offset

Menentukan offset dalam ruang data target tempat informasi dikembalikan.

[out, optional] Buffer

Menentukan buffer untuk menerima informasi. Jenis data yang dikembalikan tergantung pada nilai Yang. Jika BufferNULL, informasi ini tidak dikembalikan.

[in] BufferSize

Menentukan ukuran, dalam byte, dari buffer Buffer .

[out, optional] InfoSize

Menerima ukuran, dalam byte, dari informasi yang dikembalikan. Jika InfoSizeNULL, informasi ini tidak dikembalikan.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Persyaratan

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