Freigeben über


IDebugHostMemory::WriteBytes-Methode (dbgmodel.h)

Schreibt eine Anzahl von Bytes in den Adressraum des Ziels, wie durch den inpassierten Kontext und die Position 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 dem Bytes geschrieben werden sollen. Dies stellt z. B. den Adressraum dar, in dem der Speicherort vorhanden ist.

location

Die Position, an der Bytes geschrieben werden sollen. Dieser Speicherort kann eine virtuelle Adresse innerhalb des durch den Kontext definierten Adressraums darstellen, oder er kann ein Register in einem Kontextdatensatz für einen Thread darstellen.

buffer

Die Bytes, die in das Debugziel geschrieben werden sollen.

bufferSize

Die Größe des Puffers/der 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 teilweisen Schreibvorgang abschließen 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, das Erfolg oder Fehler angibt.

Anforderungen

Anforderung Wert
Header- dbgmodel.h

Siehe auch

IDebugHostMemory-Schnittstelle