Metode IDebugDataSpaces4::SearchVirtual (dbgeng.h)

Artikel
02/23/2024

Metode SearchVirtual mencari memori virtual target untuk pola byte tertentu.

Sintaks

HRESULT SearchVirtual(
  [in]  ULONG64  Offset,
  [in]  ULONG64  Length,
  [in]  PVOID    Pattern,
  [in]  ULONG    PatternSize,
  [in]  ULONG    PatternGranularity,
  [out] PULONG64 MatchOffset
);

Parameter

[in] Offset

Menentukan lokasi di ruang alamat virtual target untuk mulai mencari pola.

[in] Length

Menentukan seberapa jauh untuk mencari pola. Kecocokan yang berhasil mengharuskan seluruh pola ditemukan sebelum Byte panjang telah diperiksa.

[in] Pattern

Menentukan pola yang akan dicari.

[in] PatternSize

Menentukan ukuran dalam byte pola. Ini harus menjadi kelipatan granularitas pola.

[in] PatternGranularity

Menentukan granularitas pola. Agar kecocokan berhasil, pola harus terjadi kelipatan nilai ini setelah lokasi mulai.

[out] MatchOffset

Menerima lokasi di ruang alamat virtual pola target, jika ditemukan.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	Setelah memeriksa Panjang byte, pola tidak ditemukan.

Keterangan

Metode ini mencari memori virtual target untuk kejadian pertama, tunduk pada granularitas, dari pola yang sepenuhnya terkandung dalam Byte panjang memori target yang dimulai di lokasi Offset.

PatternGranularity dapat digunakan untuk memastikan keselarasan kecocokan relatif terhadap Offset. Misalnya, nilai 0x4 dapat digunakan untuk memerlukan penyelarasan ke DWORD. Nilai 0x1 dapat digunakan untuk memungkinkan pola dimulai dari mana saja.

Untuk opsi tambahan, termasuk kemampuan untuk membatasi pencarian ke memori bisa-tulis, lihat SearchVirtual2.