Metode IDebugControl::GetNearInstruction (dbgeng.h)

Artikel
02/26/2024

Metode GetNearInstruction mengembalikan lokasi instruksi prosesor relatif terhadap lokasi tertentu.

Sintaks

HRESULT GetNearInstruction(
  [in]  ULONG64  Offset,
  [in]  LONG     Delta,
  [out] PULONG64 NearOffset
);

Parameter

[in] Offset

Menentukan lokasi dalam ruang alamat virtual proses untuk mulai mencari instruksi yang diinginkan.

[in] Delta

Menentukan jumlah instruksi dari Offset dari instruksi yang diinginkan. Jika Delta negatif, offset yang dikembalikan adalah sebelum Offset (lihat bagian Keterangan untuk informasi selengkapnya).

[out] NearOffset

Menerima lokasi di ruang alamat virtual proses dari instruksi yang merupakan instruksi Delta dari Offset.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Pada beberapa arsitektur, seperti x86 dan x64, ukuran instruksi dapat bervariasi. Pada arsitektur ini, ketika Delta negatif, lokasi instruksi yang diinginkan mungkin tidak ditentukan secara unik. Dalam hal ini, mesin debugger akan mencari mundur dari Offset sampai menemukan lokasi sedemikan rupa sehingga ada jumlah instruksi Delta antara lokasi tersebut dan Offset.

Persyaratan

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