IDebugDataSpaces4::ReadPhysical2-Methode (dbgeng.h)

Artikel
02/26/2024

Die ReadPhysical2-Methode liest den Arbeitsspeicher des Ziels aus der angegebenen physischen Adresse.

Syntax

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

Parameter

[in] Offset

Gibt die physische Adresse des zu lesenden Arbeitsspeichers an.

[in] Flags

Gibt die Eigenschaften des zu lesenden physischen Arbeitsspeichers an. Dies muss mit der Art und Weise übereinstimmen, wie der physische Arbeitsspeicher für das Betriebssystem auf dem Ziel angekündigt wurde. Mögliche Werte sind in der folgenden Tabelle aufgeführt.

Wert	BESCHREIBUNG
DEBUG_PHYSICAL_DEFAULT	Verwenden Sie die Standardspeicherzwischenspeicherung.
DEBUG_PHYSICAL_CACHED	Der physische Arbeitsspeicher wird zwischengespeichert.
DEBUG_PHYSICAL_UNCACHED	Der physische Arbeitsspeicher ist nicht zwischengespeichert.
DEBUG_PHYSICAL_WRITE_COMBINED	Der physische Arbeitsspeicher wird kombiniert.

[out] Buffer

Empfängt den gelesenen Arbeitsspeicher.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Bytes an. Dies ist die maximale Anzahl von Bytes, die gelesen werden.

[out, optional] BytesRead

Empfängt die Anzahl der Bytes, die aus dem Speicher des Ziels gelesen werden. Wenn BytesReadNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Hinweise

Diese Methode ist nur beim Debuggen im Kernelmodus verfügbar.

Die Flags DEBUG_PHYSICAL_CACHED, DEBUG_PHYSICAL_UNCACHED und DEBUG_PHYSICAL_WRITE_COMBINED können nur verwendet werden, wenn es sich bei dem Ziel um ein Live-Kernelziel handelt, das standardmäßig (mit einem COM-Port, einem 1394-Bus oder einer Benannten Pipe) debuggen wird.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (einschließlich Dbgeng.h)

Weitere Informationen

IDebugDataSpaces4

ReadPhysical

WritePhysical2

Freigeben über