IDebugHostMemory::ReadBytes-Methode (dbgmodel.h)
Liest eine Anzahl von Bytes aus dem Adressraum des Ziels, wie durch den inpassierten Kontext und speicherort 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 beispielsweise den Adressraum dar, in dem sich der Speicherort befindet.
location
Der Speicherort, an dem Bytes gelesen 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 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 vom Debugziel gelesen werden, wird hier zurückgegeben. Wenn die Methode einen Teillesevorgang durchführen 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 den Erfolg oder Fehler angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |