Changeset 59348 in vbox for trunk/include/VBox

Timestamp:

Jan 14, 2016 2:48:08 PM (9 years ago)

Author:

vboxsync

Message:

Audio: Implemented dynamic fallback support to NULL audio backends for HDA, AC'97 and SB16 emulation; also did some preparations for audio hotplugging support.

Location:

trunk/include/VBox/vmm

Files:

• pdmaudioifs.h (modified) (1 diff)
• pdmdev.h (modified) (7 diffs)

trunk/include/VBox/vmm/pdmaudioifs.h

@@ -539 +539 @@
 
     /**
-     * Initializes the NULL audio driver as a fallback in case no host backend is available.
-     *
-     * @returns VBox status code.
-     * @param   pInterface      Pointer to the interface structure containing the called function pointer.
-     */
-    DECLR3CALLBACKMEMBER(int, pfnInitNull, (PPDMIAUDIOCONNECTOR pInterface));
-
-    /**
      * Enables a specific guest output stream and starts the audio device.
      *

trunk/include/VBox/vmm/pdmdev.h

@@ -4 +4 @@
 
 /*
- * Copyright (C) 2006-2015 Oracle Corporation
+ * Copyright (C) 2006-2016 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
@@ -178 +178 @@
  * This is called to let the device attach to a driver for a specified LUN
  * at runtime. This is not called during VM construction, the device
- * constructor have to attach to all the available drivers.
+ * constructor has to attach to all the available drivers.
  *
  * This is like plugging in the keyboard or mouse after turning on the PC.
@@ -184 +184 @@
  * @returns VBox status code.
  * @param   pDevIns     The device instance.
- * @param   iLUN        The logical unit which is being detached.
+ * @param   iLUN        The logical unit which is being attached.
  * @param   fFlags      Flags, combination of the PDM_TACH_FLAGS_* \#defines.
  *
@@ -197 +197 @@
  *
  * This is called when a driver is detaching itself from a LUN of the device.
- * The device should adjust it's state to reflect this.
+ * The device should adjust its state to reflect this.
  *
  * This is like unplugging the network cable to use it for the laptop or
@@ -3068 +3068 @@
 
     /**
+     * Detaches an attached driver (chain) from the device again.
+     *
+     * @returns VBox status code.
+     * @param   pDevIns             The device instance.
+     * @param   pDrvIns             The driver instance to detach.
+     * @param   fFlags              Flags, combination of the PDMDEVATT_FLAGS_* \#defines.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnDriverDetach,(PPDMDEVINS pDevIns, PPDMDRVINS pDrvIns, uint32_t fFlags));
+
+    /**
      * Create a queue.
      *
@@ -3672 +3682 @@
 
 /** Current PDMDEVHLPR3 version number. */
-#define PDM_DEVHLPR3_VERSION                    PDM_VERSION_MAKE(0xffe7, 14, 1)
+#define PDM_DEVHLPR3_VERSION                    PDM_VERSION_MAKE(0xffe7, 15, 1)
 
 
@@ -4938 +4948 @@
 
 /**
+ * @copydoc PDMDEVHLPR3::pfnDriverDetach
+ */
+DECLINLINE(int) PDMDevHlpDriverDetach(PPDMDEVINS pDevIns, PPDMDRVINS pDrvIns, uint32_t fFlags)
+{
+    return pDevIns->pHlpR3->pfnDriverDetach(pDevIns, pDrvIns, fFlags);
+}
+
+/**
  * @copydoc PDMDEVHLPR3::pfnQueueCreate
  */