Changeset 19562 in vbox for trunk/src/VBox/Runtime/include/internal/fileaio.h

Timestamp:

May 10, 2009 9:44:16 PM (16 years ago)

Author:

vboxsync

Message:

Runtime/Aio: Change API again

• pcReqs in RTFileAioCtxSubmit is useless because it does not specify which request fails. Removed it again and made it possible to get the state of a request through RTFileAioReqGetRC()
• Introduce request states for the first point and to catch more errors using the API before a system dependent call is made to return the same error codes one every system for the same cause.
• Add RTFileAioGetLimits to get global limits and indication for AIO support.
• General cleanups and fixes

File:

• trunk/src/VBox/Runtime/include/internal/fileaio.h (modified) (2 diffs)

trunk/src/VBox/Runtime/include/internal/fileaio.h

@@ -36 +36 @@
 
 /*******************************************************************************
+*   Structures and Typedefs                                                    *
+*******************************************************************************/
+/**
+ * Defined request states.
+ */
+typedef enum RTFILEAIOREQSTATE
+{
+    /** Prepared. */
+    RTFILEAIOREQSTATE_PREPARED = 0,
+    /** Submitted. */
+    RTFILEAIOREQSTATE_SUBMITTED,
+    /** Completed. */
+    RTFILEAIOREQSTATE_COMPLETED,
+    /** Omni present 32bit hack. */
+    RTFILEAIOREQSTATE_32BIT_HACK = 0x7fffffff
+} RTFILEAIOREQSTATE;
+
+/*******************************************************************************
 *   Defined Constants And Macros                                               *
 *******************************************************************************/
+
+/** Return true if the specified request is not valid, false otherwise. */
+#define RTFILEAIOREQ_IS_NOT_VALID(pReq) \
+    (RT_UNLIKELY(!VALID_PTR(pReq) || (pReq->u32Magic != RTFILEAIOREQ_MAGIC)))
 
 /** Validates a context handle and returns VERR_INVALID_HANDLE if not valid. */
@@ -66 +88 @@
 #define RTFILEAIOCTX_VALID_RETURN(pCtx) RTFILEAIOCTX_VALID_RETURN_RC((pCtx), VERR_INVALID_HANDLE)
 
+/** Checks if a request is in the specified state and returns the specified rc if not. */
+#define RTFILEAIOREQ_STATE_RETURN_RC(pReq, State, rc) \
+    do { \
+        if (RT_UNLIKELY(pReq->enmState != RTFILEAIOREQSTATE_##State)) \
+            return rc; \
+    } while (0)
+
+/** Checks if a request is not in the specified state and returns the specified rc if it is. */
+#define RTFILEAIOREQ_NOT_STATE_RETURN_RC(pReq, State, rc) \
+    do { \
+        if (RT_UNLIKELY(pReq->enmState == RTFILEAIOREQSTATE_##State)) \
+            return rc; \
+    } while (0)
+
+/** Sets the request into a specific state. */
+#define RTFILEAIOREQ_SET_STATE(pReq, State) \
+    do { \
+        pReq->enmState = RTFILEAIOREQSTATE_##State; \
+    } while (0)
+
+
 __BEGIN_DECLS