IDebugDataSpaces4::ReadVirtualUncached-Methode (dbgeng.h)

Artikel
02/26/2024

Die ReadVirtualUncached-Methode liest Arbeitsspeicher 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 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 zurückgegeben wird.

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 verhält sich identisch mit ReadVirtual, mit der Ausnahme, dass sie die Verwendung des virtuellen Speichercaches vermeidet. Es ist daher nützlich, um inhärent flüchtigen virtuellen Speicher zu lesen, z. B. speicherseitig zugeordnete Gerätebereiche, ohne den Cache zu verunreinigen oder zu ungültig machen.