IDebugSymbols3::ReadTypedDataVirtual-Methode (dbgeng.h)

Artikel
02/26/2024

Die ReadTypedDataVirtual-Methode liest den Wert einer Variablen im virtuellen Speicher des Ziels.

Syntax

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

Parameter

[in] Offset

Gibt den Speicherort im virtuellen Adressraum des Ziels der zu lesenden Variablen an.

[in] Module

Gibt die Basisadresse des Moduls an, das den Typ der Variablen enthält.

[in] TypeId

Gibt die Typ-ID des Typs an.

[out] Buffer

Empfängt die gelesenen Daten.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Byte an. Dies ist die maximale Anzahl der zu lesenden Bytes.

[out, optional] BytesRead

Empfängt die Anzahl der gelesenen Bytes. Wenn BytesReadNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Der Pufferpuffer war jedoch nicht groß genug, um alle Daten aufzunehmen, und er wurde abgeschnitten.

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Hinweise

Die Anzahl der Bytes, die diese Methode zu lesen versucht, ist die kleinere Größe des Puffers und die Größe der Variablen.

Dies ist eine bequeme Methode. Dasselbe Ergebnis kann durch Aufrufen von GetTypeSize und ReadVirtual abgerufen werden.

Weitere Informationen zu Typen finden Sie unter Typen.

Anforderungen

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