IDebugDataSpaces4::ReadVirtual-Methode (dbgeng.h)

Artikel
02/06/2025

Die ReadVirtual--Methode liest den Speicher 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 Adressbereich des Ziels an, der gelesen werden soll.

[out] Buffer

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

[in] BufferSize

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

[out, optional] BytesRead

Empfängt die Anzahl der gelesenen Bytes. 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 von Daten zurückgegeben wurde.

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

Bemerkungen

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

Diese Methode kann beim Abrufen von Daten auf einen Cache von Speicherdaten verweisen. Wenn die Daten veränderlich sind, z. B. vom Speicher zugeordneter Hardwarestatus, verwenden Sie stattdessen ReadVirtualUncached.

Beim Lesen des Speichers, der Zeiger enthält, gelten diese Zeiger für den virtuellen Adressraum des Ziels und nicht für das Modul. Wenn beispielsweise eine Datenstruktur eine Zeichenfolge enthielt, kann ein zweiter Aufruf dieser Methode erforderlich sein, um den Inhalt der Zeichenfolge zu lesen.