Share via

IDebugDisassemblyStream2::Read

  • Artikel

Liest Anweisungen ab der aktuellen Position im Demontagedatenstrom.

Syntax

int Read( 
   uint                           dwInstructions,
   enum_DISASSEMBLY_STREAM_FIELDS dwFields,
   out uint                       pdwInstructionsRead,
   DisassemblyData[]              prgDisassembly
);

Parameter

dwInstructions
[in] Die Anzahl der Anweisungen zum Zerlegen. Dieser Wert ist auch die maximale Länge des prgDisassembly Arrays.

dwFields
[in] Eine Kombination von Flags aus der DISASSEMBLY_STREAM_FIELDS Enumeration, die angibt, welche Felder prgDisassembly ausgefüllt werden sollen.

pdwInstructionsRead
[out] Gibt die Anzahl der tatsächlich zerlegten Anweisungen zurück.

prgDisassembly
[out] Ein Array von DisassemblyData-Strukturen , die mit dem zerlegten Code gefüllt sind, eine Struktur pro demontierte Anweisung. Die Länge dieses Arrays wird durch den dwInstructions Parameter bestimmt.

Rückgabewert

Wenn die Ausführung erfolgreich ist, wird S_OK, andernfalls ein Fehlercode zurückgegeben.

Hinweise

Die maximale Anzahl von Anweisungen, die im aktuellen Bereich verfügbar sind, können durch Aufrufen der GetSize-Methode abgerufen werden.

Die aktuelle Position, von der die nächste Anweisung gelesen wird, kann durch Aufrufen der Seek-Methode geändert werden.

Das DSF_OPERANDS_SYMBOLS Kennzeichen kann dem DSF_OPERANDS Kennzeichen im dwFields Parameter hinzugefügt werden, um anzugeben, dass Symbolnamen beim Zerlegen von Anweisungen verwendet werden sollen.

Siehe auch