IDebugSymbols3::WriteTypedDataPhysical-Methode (dbgeng.h)

Artikel
02/23/2024

Die WriteTypedDataPhysical-Methode schreibt den Wert einer Variablen in den physischen Arbeitsspeicher des Zielcomputers.

Syntax

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

Parameter

[in] Offset

Gibt die physische Adresse im Arbeitsspeicher des Zielcomputers der 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 der Variablen an.

[in] Buffer

Gibt den Puffer an, der die zu schreibenden Daten enthält.

[in] BufferSize

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

[out, optional] BytesWritten

Empfängt die Anzahl von Bytes, die geschrieben wurden. Wenn BytesWrittenNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Alle Bytes im Pufferpuffer wurden geschrieben. Der Puffer war jedoch kleiner als die Größe des angegebenen Typs.

Hinweise

Diese Methode ist nur im Kernelmodusdebuggen verfügbar.

Die Anzahl der Bytes, die diese Methode zu schreiben 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 WritePhysical erzielt werden.

Weitere Informationen zu Typen finden Sie unter Typen.

Anforderungen

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