Changeset 41760 in vbox for trunk/include/VBox

Timestamp:

Jun 15, 2012 3:56:20 PM (13 years ago)

Author:

vboxsync

Message:

DIS: Chagned FNDISREADBYTES to permit reading more bytes that the immeidate request. Not using the read-ahead feature in any important code path yet, that's comming next, bit by bit.

File:

• trunk/include/VBox/dis.h (modified) (1 diff)

trunk/include/VBox/dis.h

@@ -497 +497 @@
 
 /**
- * Callback for reading opcode bytes.
- *
- * @param   pDisState       Pointer to the CPU state.  The primary user argument
- *                          can be retrived from DISCPUSTATE::pvUser. If
- *                          more is required these can be passed in the
- *                          subsequent slots.
- * @param   pbDst           Pointer to output buffer.
- * @param   uSrcAddr        The address to start reading at.
- * @param   cbToRead        The number of bytes to read.
- */
-typedef DECLCALLBACK(int) FNDISREADBYTES(PDISCPUSTATE pDisState, uint8_t *pbDst, RTUINTPTR uSrcAddr, uint32_t cbToRead);
+ * Callback for reading instruction bytes.
+ *
+ * @returns VBox status code, bytes in DISCPUSTATE::abInstr and byte count in
+ *          DISCPUSTATE::cbCachedInstr.
+ * @param   pDis            Pointer to the disassembler state.  The user
+ *                          argument can be found in DISCPUSTATE::pvUser if
+ *                          needed.
+ * @param   offInstr        The offset relative to the start of the instruction.
+ *
+ *                          To get the source address, add this to
+ *                          DISCPUSTATE::uInstrAddr.
+ *
+ *                          To calculate the destination buffer address, use it
+ *                          as an index into DISCPUSTATE::abInstr.
+ *
+ * @param   cbMinRead       The minimum number of bytes to read.
+ * @param   cbMaxRead       The maximum number of bytes that may be read.
+ */
+typedef DECLCALLBACK(int) FNDISREADBYTES(PDISCPUSTATE pDis, uint8_t offInstr, uint8_t cbMinRead, uint8_t cbMaxRead);
 /** Pointer to a opcode byte reader. */
 typedef FNDISREADBYTES *PFNDISREADBYTES;