IDebugSymbols2::ReadTypedDataPhysical-Methode (dbgeng.h)

Artikel
02/23/2024

Die ReadTypedDataPhysical-Methode liest den Wert einer Variablen aus dem physischen Arbeitsspeicher des Zielcomputers.

Syntax

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

Parameter

[in] Offset

Gibt die physische Adresse der zu lesenden Variablen im Arbeitsspeicher des Zielcomputers an.

[in] Module

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

[in] TypeId

Gibt die Typ-ID des Typs der Variablen an.

[out] Buffer

Empfängt die gelesenen Daten.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Bytes an. Dies ist die maximale Anzahl von Bytes, die gelesen werden.

[out, optional] BytesRead

Empfängt die Anzahl der Bytes, die gelesen wurden. 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 kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Hinweise

Diese Methode ist nur im Kernelmodusdebuggen verfügbar.

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 Komfortmethode. Das gleiche Ergebnis kann durch Aufrufen von GetTypeSize und ReadPhysical erzielt werden.

Weitere Informationen zu Typen finden Sie unter Typen.

Anforderungen

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