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

Timestamp:

Mar 9, 2021 3:33:52 PM (4 years ago)

Author:

vboxsync

Message:

Audio: Adding a magic to PDMAUDIOSTREAM. bugref:9890

File:

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

trunk/include/VBox/vmm/pdmaudioifs.h

@@ -1244 +1244 @@
 typedef struct PDMAUDIOSTREAM *PPDMAUDIOSTREAMCTX;
 
+/** @name PDMAUDIOSTREAM_WARN_FLAGS_XXX
+ * @{ */
 /** No stream warning flags set. */
 #define PDMAUDIOSTREAM_WARN_FLAGS_NONE          0
 /** Warned about a disabled stream. */
 #define PDMAUDIOSTREAM_WARN_FLAGS_DISABLED      RT_BIT(0)
+/** @} */
 
 /**
@@ -1254 +1257 @@
 typedef struct PDMAUDIOSTREAM
 {
-    /** List node.
-     * @todo s/Node/ListEntry/ */
-    RTLISTNODE              Node;
-    /** @todo add magic (some jazz pianist). */
+    /** Magic value (PDMAUDIOSTREAM_MAGIC). */
+    uint32_t                uMagic;
+    /** Size (in bytes) of the backend-specific stream data. */
+    uint32_t                cbBackend;
+    /** List entry (some DrvAudio internal list). */
+    RTLISTNODE              ListEntry;
     /** Number of references to this stream.
      *  Only can be destroyed when the reference count reaches 0. */
@@ -1264 +1269 @@
     uint32_t                cTriesReInit;
     /** Warnings shown already in the release log.
-     *  See PDMAUDIOSTREAM_WARN_FLAGS_XXX defines. */
+     *  See PDMAUDIOSTREAM_WARN_FLAGS_XXX. */
     uint32_t                fWarningsShown;
     /** Stream status flag. */
@@ -1295 +1300 @@
      *  That way the backends do not have access to the audio connector's data. */
     void                   *pvBackend;
-    /** Size (in bytes) of the backend-specific stream data. */
-    size_t                  cbBackend;
 
     /** Name of this stream. */
@@ -1308 +1311 @@
     } RT_UNION_NM(u);
 } PDMAUDIOSTREAM;
+
+/** Magic value for PDMAUDIOSTREAM. (Ahmad Jamal)   */
+#define PDMAUDIOSTREAM_MAGIC    UINT32_C(0x19300702)