IDebugDataSpaces3::ReadVirtual-Methode (dbgeng.h)

Artikel
02/23/2024

Die ReadVirtual-Methode liest Arbeitsspeicher aus dem virtuellen Adressraum des Ziels.

Syntax

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

Parameter

[in] Offset

Gibt den Speicherort im virtuellen Adressraum des Ziels an, der gelesen werden soll.

[out] Buffer

Gibt den Puffer an, in den der Arbeitsspeicher gelesen werden soll.

[in] BufferSize

Gibt die Größe des Puffers in Bytes an. Dies ist auch die Anzahl der angeforderten Bytes.

[out, optional] BytesRead

Empfängt die Anzahl der Bytes, die gelesen wurden. Wenn sie auf NULL festgelegt ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich. Es ist möglich, dass BytesRead kleiner als BufferSize ist, aber mindestens ein Byte Daten wurde zurückgegeben.

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

Hinweise

Diese Methode füllt den Puffer mit dem Inhalt des Arbeitsspeichers im virtuellen Adressraum des Ziels.

Diese Methode kann beim Abrufen von Daten auf einen Cache mit Speicherdaten verweisen. Wenn die Daten volatil sind, z. B. speicherseitig zugeordneter Hardwarezustand, verwenden Sie stattdessen ReadVirtualUncached .

Beim Lesen von Arbeitsspeicher, der Zeiger enthält, sind diese Zeiger für den virtuellen Adressraum des Ziels und nicht für den des Moduls. Wenn eine Datenstruktur beispielsweise eine Zeichenfolge enthält, ist möglicherweise ein zweiter Aufruf dieser Methode erforderlich, um den Inhalt der Zeichenfolge zu lesen.