Changeset 27933 in vbox for trunk/include/VBox

Timestamp:

Apr 1, 2010 12:41:47 PM (15 years ago)

Author:

vboxsync

Message:

DrvNamedPipe.cpp: Don't assume we'll get a PowerOff call. Always wait for the thread as we created it with RTTHREADFLAGS_WAITABLE. Use volatile on fShutdown. Must shutdown the server socket or accept() might not abort.

File:

• trunk/include/VBox/pdmdrv.h (modified) (3 diffs)

trunk/include/VBox/pdmdrv.h

@@ -406 +406 @@
  * Intended for the constructor.
  *
- * @param   pDrvIns     The drvice instance pointer.
+ * @param   pDrvIns             Pointer to the PDM driver instance.
  */
 #define PDMDRV_CHECK_VERSIONS_RETURN(pDrvIns) \
@@ -426 +426 @@
  * Intended for the destructor.
  *
- * @param   pDrvIns     The drvice instance pointer.
+ * @param   pDrvIns             Pointer to the PDM driver instance.
  */
 #define PDMDRV_CHECK_VERSIONS_RETURN_VOID(pDrvIns) \
@@ -437 +437 @@
     } while (0)
 
+/**
+ * Wrapper around CFGMR3ValidateConfig for the root config for use in the
+ * constructor - returns on failure.
+ *
+ * This should be invoked after having initialized the instance data
+ * sufficiently for the correct operation of the destructor.  The destructor is
+ * always called!
+ *
+ * @param   pDrvIns             Pointer to the PDM driver instance.
+ * @param   pszValidValues      Patterns describing the valid value names.  See
+ *                              RTStrSimplePatternMultiMatch for details on the
+ *                              pattern syntax.
+ * @param   pszValidNodes       Patterns describing the valid node (key) names.
+ *                              Pass empty string if no valid nodess.
+ */
+#define PDMDRV_VALIDATE_CONFIG_RETURN(pDrvIns, pszValidValues, pszValidNodes) \
+    do \
+    { \
+        int rcValCfg = CFGMR3ValidateConfig((pDrvIns)->pCfg, "/", pszValidValues, pszValidNodes, \
+                                            (pDrvIns)->pReg->szName, (pDrvIns)->iInstance); \
+        if (RT_FAILURE(rcValCfg)) \
+            return rcValCfg; \
+    } while (0)