Metode IDebugDataSpaces4::ReadPhysical2 (dbgeng.h)

Artikel
02/23/2024

Metode ReadPhysical2 membaca memori target dari alamat fisik yang ditentukan.

Sintaks

HRESULT ReadPhysical2(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Parameter

[in] Offset

Menentukan alamat fisik memori yang akan dibaca.

[in] Flags

Menentukan properti memori fisik yang akan dibaca. Ini harus cocok dengan cara memori fisik diiklankan ke sistem operasi pada target. Nilai yang mungkin tercantum dalam tabel berikut ini.

Nilai	Deskripsi
DEBUG_PHYSICAL_DEFAULT	Gunakan penembolokan memori default.
DEBUG_PHYSICAL_CACHED	Memori fisik di-cache.
DEBUG_PHYSICAL_UNCACHED	Memori fisik tidak di-cache.
DEBUG_PHYSICAL_WRITE_COMBINED	Memori fisik digabungkan dengan tulis.

[out] Buffer

Menerima memori yang dibaca.

[in] BufferSize

Menentukan ukuran, dalam byte, dari buffer Buffer . Ini adalah jumlah maksimum byte yang akan dibaca.

[out, optional] BytesRead

Menerima jumlah byte yang dibaca dari memori target. Jika BytesReadNULL, informasi ini tidak dikembalikan.

Nilai kembali

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

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

Keterangan

Metode ini hanya tersedia dalam penelusuran kesalahan mode kernel.

Bendera DEBUG_PHYSICAL_CACHED, DEBUG_PHYSICAL_UNCACHED, dan DEBUG_PHYSICAL_WRITE_COMBINED hanya dapat digunakan ketika target adalah target kernel langsung yang sedang di-debug dengan cara standar (menggunakan port COM, bus 1394, atau pipa bernama).

Persyaratan

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

Lihat juga

IDebugDataSpaces4

ReadPhysical

WritePhysical2