IDebugDataSpaces4::WritePhysical2-Methode (dbgeng.h)

Artikel
03/01/2024

Die WritePhysical2-Methode schreibt Daten in die angegebene physische Adresse im Speicher des Ziels.

Syntax

HRESULT WritePhysical2(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [in]            PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesWritten
);

Parameter

[in] Offset

Gibt die physische Adresse des Arbeitsspeichers an, in den die Daten geschrieben werden sollen.

[in] Flags

Gibt die Eigenschaften des physischen Speichers an, in den geschrieben werden soll. Dies muss mit der Art und Weise übereinstimmen, wie der physische Arbeitsspeicher für das Betriebssystem auf dem Ziel angekündigt wurde. Mögliche Werte sind in der folgenden Tabelle aufgeführt.

Wert	BESCHREIBUNG
DEBUG_PHYSICAL_DEFAULT	Verwenden Sie die Standardspeicherung des Arbeitsspeichers.
DEBUG_PHYSICAL_CACHED	Der physische Arbeitsspeicher wird zwischengespeichert.
DEBUG_PHYSICAL_UNCACHED	Der physische Arbeitsspeicher ist nicht zwischengespeichert.
DEBUG_PHYSICAL_WRITE_COMBINED	Der physische Arbeitsspeicher ist kombiniert mit Schreibvorgängen.

[in] Buffer

Gibt die zu schreibenden Daten an.

[in] BufferSize

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

[out, optional] BytesWritten

Empfängt die Anzahl von Bytes, die in den Arbeitsspeicher des Ziels geschrieben werden. Wenn BytesWrittenden Wert NULL aufweist, 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.

Hinweise

Diese Methode ist nur im Kernelmodusdebuggen verfügbar.

Die Flags DEBUG_PHYSICAL_CACHED, DEBUG_PHYSICAL_UNCACHED und DEBUG_PHYSICAL_WRITE_COMBINED können nur verwendet werden, wenn das Ziel ein Livekernkernziel ist, das standardmäßig (mit einem COM-Port, 1394-Bus oder Named Pipe) debuggt wird.