IDebugHostMemory2::ReadBytes-Methode (dbgmodel.h)
Liest eine Anzahl von Bytes aus dem Adressraum des Ziels, wie durch den inpassierten Kontext und die Position definiert. Die Anzahl der gelesenen Bytes wird bei Erfolg in "bytesRead" zurückgegeben.
Syntax
HRESULT ReadBytes(
IDebugHostContext *context,
Location location,
void *buffer,
ULONG64 bufferSize,
ULONG64 *bytesRead
);
Parameter
context
Der Hostkontext, in dem Bytes gelesen werden sollen. Dies stellt z. B. den Adressraum dar, in dem der Speicherort vorhanden ist.
location
Der Speicherort, an dem Bytes gelesen 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 aus dem Debugziel gelesenen Bytes werden in diesen Puffer geschrieben.
bufferSize
Die Größe des Puffers und die Anzahl der zu lesenden Bytes.
bytesRead
Die Anzahl der Bytes, die tatsächlich aus dem Debugziel gelesen werden, wird hier zurückgegeben. Wenn die Methode ein teilweises Lesen abschließen kann, wird S_FALSE zurückgegeben, und der Wert in bytesRead kann kleiner als die angeforderte Anzahl von Bytes sein. Wenn die Methode S_OK zurückgibt, wurde ein vollständiger Lesevorgang abgeschlossen.
Rückgabewert
Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.
Anforderungen
Anforderung | Wert |
---|---|
Header- | dbgmodel.h |