Freigeben über


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

Siehe auch

IDebugHostMemory2-Schnittstelle