IDebugDataSpaces3::ReadVirtualUncached-Methode (dbgeng.h)

Artikel
02/06/2025

Die ReadVirtualUncached- Methode liest den Speicher aus dem virtuellen Adressraum des Ziels.

Syntax

HRESULT ReadVirtualUncached(
  [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 wird.

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 verhält sich identisch mit ReadVirtual-, außer dass die Verwendung des virtuellen Speichercaches vermieden wird. Daher ist es nützlich, inhärent veränderliche virtuelle Speicher zu lesen, z. B. speicherzuordnungen Gerätebereiche, ohne den Cache zu verunreinigen oder zu ungültig machen.