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 |