IDebugHostMemory2::WriteBytes-Methode (dbgmodel.h)

Schreibt eine Anzahl von Bytes in den Adressraum des Ziels, wie durch den inpassierten Kontext und speicherort definiert.

Die Anzahl der geschriebenen Bytes wird bei Erfolg in "bytesWritten" zurückgegeben.

Syntax

HRESULT WriteBytes(
  IDebugHostContext *context,
  Location          location,
  void              *buffer,
  ULONG64           bufferSize,
  ULONG64           *bytesWritten
);

Parameter

context

Der Hostkontext, in den Bytes geschrieben werden sollen. Dies stellt beispielsweise den Adressraum dar, in dem sich der Speicherort befindet.

location

Der Speicherort, an dem Bytes geschrieben werden sollen. Dieser Speicherort kann eine virtuelle Adresse innerhalb des durch den Kontext definierten Adressraums oder ein Register innerhalb eines Kontextdatensatzes für einen Thread darstellen.

buffer

Die Bytes, die in das Debugziel geschrieben werden sollen.

bufferSize

Die Größe des Puffers/anzahl der Bytes, die in das Debugziel geschrieben werden sollen.

bytesWritten

Die Anzahl der Bytes, die tatsächlich in das Debugziel geschrieben wurden, wird hier zurückgegeben. Wenn die Methode einen partiellen Schreibvorgang durchführen kann, wird S_FALSE zurückgegeben, und der Wert in bytesWritten kann kleiner als die angeforderte Anzahl von Bytes sein. Wenn die Methode S_OK zurückgibt, wurde ein vollständiger Schreibvorgang abgeschlossen.

Rückgabewert

Diese Methode gibt HRESULT zurück.

Anforderungen

Anforderung	Wert
Header	dbgmodel.h