Changeset 64407 in vbox for trunk/include

Timestamp:

Oct 25, 2016 11:53:00 AM (9 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

111521

Message:

Devices/Storage: Add callback to query the actual transfer size of an I/O request if PDMIMEDIAEX is used, useful to calculate the amount of data transferred for requests where the transfer size can be different from the guest buffer size (e.g. SCSI)

File:

• trunk/include/VBox/vmm/pdmstorageifs.h (modified) (2 diffs)

trunk/include/VBox/vmm/pdmstorageifs.h

@@ -731 +731 @@
 
     /**
+     * Queries the residual amount of data not transfered when the request completed.
+     *
+     * @returns VBox status code.
+     * @retval  VERR_PDM_MEDIAEX_IOREQ_INVALID_STATE has not completed yet.
+     * @param   pInterface      Pointer to the interface structure containing the called function pointer.
+     * @param   hIoReq          The I/O request.
+     * @param   pcbXfer         Where to store the amount of resdiual data in bytes.
+     * @thread  Any thread.
+     *
+     * @note For simple read/write requests this returns the amount to read/write as given to the
+     *       PDMIMEDIAEX::pfnIoReqRead or PDMIMEDIAEX::pfnIoReqWrite call.
+     *       For SCSI commands this returns the transfer size as given in the provided CDB.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnIoReqQueryXferSize, (PPDMIMEDIAEX pInterface, PDMMEDIAEXIOREQ hIoReq, size_t *pcbXfer));
+
+    /**
      * Cancels all I/O active requests.
      *
@@ -917 +933 @@
 } PDMIMEDIAEX;
 /** PDMIMEDIAEX interface ID. */
-#define PDMIMEDIAEX_IID                      "134a5ba9-0d6c-443f-8619-14fea6caaa8d"
+#define PDMIMEDIAEX_IID                      "1f82b709-a9f7-4928-ad50-e879c9bbeba1"
 
 /**