Changeset 88044 in vbox for trunk/include/VBox/vmm

Timestamp:

Mar 9, 2021 1:18:37 PM (4 years ago)

Author:

vboxsync

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

143175

Message:

Audio: More prep work to move the audio device enumeration code to PDM. bugref:9890

File:

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

trunk/include/VBox/vmm/pdmaudioifs.h

@@ -352 +352 @@
 /**
  * Audio device info (enumeration result).
- * @sa PDMAUDIODEVICEENUM, PDMIHOSTAUDIO::pfnGetDevices
+ * @sa PDMAUDIOHOSTENUM, PDMIHOSTAUDIO::pfnGetDevices
  */
 typedef struct PDMAUDIODEVICE
 {
-    /** List entry (like PDMAUDIODEVICEENUM::LstDevices). */
+    /** List entry (like PDMAUDIOHOSTENUM::LstDevices). */
     RTLISTNODE          Node;
     /** Magic value (PDMAUDIODEVICE_MAGIC). */
@@ -404 +404 @@
 
 /**
- * An audio device enumeration result.
+ * A host audio device enumeration result.
  *
  * @sa PDMIHOSTAUDIO::pfnGetDevices
  */
-typedef struct PDMAUDIODEVICEENUM
-{
+typedef struct PDMAUDIOHOSTENUM
+{
+    /** Magic value (PDMAUDIOHOSTENUM_MAGIC). */
+    uint32_t        uMagic;
+    /** Number of audio devices in the list. */
+    uint32_t        cDevices;
     /** List of audio devices (PDMAUDIODEVICE). */
     RTLISTANCHOR    LstDevices;
-    /** Number of audio devices in the list. */
-    uint32_t        cDevices;
-} PDMAUDIODEVICEENUM;
+} PDMAUDIOHOSTENUM;
 /** Pointer to an audio device enumeration result. */
-typedef PDMAUDIODEVICEENUM *PPDMAUDIODEVICEENUM;
+typedef PDMAUDIOHOSTENUM *PPDMAUDIOHOSTENUM;
 /** Pointer to a const audio device enumeration result. */
-typedef PDMAUDIODEVICEENUM const *PCPDMAUDIODEVICEENUM;
+typedef PDMAUDIOHOSTENUM const *PCPDMAUDIOHOSTENUM;
+
+/** Magic for the host audio device enumeration. (Herbert Jeffrey "Herbie" Hancock) */
+#define PDMAUDIOHOSTENUM_MAGIC      UINT32_C(0x19400412)
+
 
 /**
@@ -1652 +1658 @@
      * @param   pDeviceEnum         Where to return the enumerated audio devices.
      */
-    DECLR3CALLBACKMEMBER(int, pfnGetDevices, (PPDMIHOSTAUDIO pInterface, PPDMAUDIODEVICEENUM pDeviceEnum));
+    DECLR3CALLBACKMEMBER(int, pfnGetDevices, (PPDMIHOSTAUDIO pInterface, PPDMAUDIOHOSTENUM pDeviceEnum));
 
     /**