Changeset 52023 in vbox for trunk/include/VBox

Timestamp:

Jul 14, 2014 9:00:18 PM (11 years ago)

Author:

vboxsync

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

94998

Message:

pdmifs.h,DrvBlock,DrvVD: Add methods to allocate and free I/O buffer memory to PDMIBLOCK and PDMIMEDIA. DrvVD decides how to allocate the memory based on the setup

File:

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

trunk/include/VBox/vmm/pdmifs.h

@@ -1136 +1136 @@
      */
     DECLR3CALLBACKMEMBER(int, pfnDiscard,(PPDMIBLOCK pInterface, PCRTRANGE paRanges, unsigned cRanges));
+
+    /**
+     * Allocate buffer memory which is suitable for I/O and might have special proerties for secure
+     * environments (non-pageable memory for sensitive data which should not end up on the disk).
+     *
+     * @returns VBox status code.
+     * @param   pInterface      Pointer to the interface structure containing the called function pointer.
+     * @param   cb              Amount of memory to allocate.
+     * @param   ppvNew          Where to store the pointer to the buffer on success.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnIoBufAlloc, (PPDMIBLOCK pInterface, size_t cb, void **ppvNew));
+
+    /**
+     * Free memory allocated with PDMIBLOCK::pfnIoBufAlloc().
+     *
+     * @returns VBox status code.
+     * @param   pInterface      Pointer to the interface structure containing the called function pointer.
+     * @param   pv              Pointer to the memory to free.
+     * @param   cb              Amount of bytes given in PDMIBLOCK::pfnIoBufAlloc().
+     */
+    DECLR3CALLBACKMEMBER(int, pfnIoBufFree, (PPDMIBLOCK pInterface, void *pv, size_t cb));
+
 } PDMIBLOCK;
 /** PDMIBLOCK interface ID. */
-#define PDMIBLOCK_IID                           "5e7123dd-8cdf-4a6e-97a5-ab0c68d7e850"
+#define PDMIBLOCK_IID                           "4e804e8e-3c01-4f20-98d9-a30ece8ec9f5"
 
 
@@ -1494 +1516 @@
     DECLR3CALLBACKMEMBER(int, pfnDiscard,(PPDMIMEDIA pInterface, PCRTRANGE paRanges, unsigned cRanges));
 
+    /**
+     * Allocate buffer memory which is suitable for I/O and might have special proerties for secure
+     * environments (non-pageable memory for sensitive data which should not end up on the disk).
+     *
+     * @returns VBox status code.
+     * @param   pInterface      Pointer to the interface structure containing the called function pointer.
+     * @param   cb              Amount of memory to allocate.
+     * @param   ppvNew          Where to store the pointer to the buffer on success.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnIoBufAlloc, (PPDMIMEDIA pInterface, size_t cb, void **ppvNew));
+
+    /**
+     * Free memory allocated with PDMIMEDIA::pfnIoBufAlloc().
+     *
+     * @returns VBox status code.
+     * @param   pInterface      Pointer to the interface structure containing the called function pointer.
+     * @param   pv              Pointer to the memory to free.
+     * @param   cb              Amount of bytes given in PDMIMEDIA::pfnIoBufAlloc().
+     */
+    DECLR3CALLBACKMEMBER(int, pfnIoBufFree, (PPDMIMEDIA pInterface, void *pv, size_t cb));
+
 } PDMIMEDIA;
 /** PDMIMEDIA interface ID. */
-#define PDMIMEDIA_IID                           "ec385d21-7aa9-42ca-8cfb-e1388297fa52"
+#define PDMIMEDIA_IID                           "b4acf420-c9e3-4333-9ed5-e86f6b2d5f1a"