Changeset 88954 in vbox for trunk

Timestamp:

May 9, 2021 12:48:03 AM (4 years ago)

Author:

vboxsync

Message:

Audio: doxygen and stats tweaks. bugref:9890

Location:

trunk/src/VBox/Devices/Audio

Files:

• DevHdaStream.cpp (modified) (1 diff)
• DevIchAc97.cpp (modified) (6 diffs)

trunk/src/VBox/Devices/Audio/DevHdaStream.cpp

@@ -2162 +2162 @@
 
 /**
- * @callback_method_impl{FNRTTHREAD, Asynchronous I/O thread for a HDA stream.}
+ * @callback_method_impl{FNAUDMIXSINKUPDATE}
  *
  * For output streams this moves data from the internal DMA buffer (in which

trunk/src/VBox/Devices/Audio/DevIchAc97.cpp

@@ -334 +334 @@
     /** Circular buffer (FIFO) for holding DMA'ed data. */
     R3PTRTYPE(PRTCIRCBUF)   pCircBuf;
+#if HC_ARCH_BITS == 32
+    uint32_t                Padding;
+#endif
     /** Current circular buffer read offset (for tracing & logging). */
     uint64_t                offRead;
     /** Current circular buffer write offset (for tracing & logging). */
     uint64_t                offWrite;
-#if HC_ARCH_BITS == 32
-    uint32_t                Padding;
-#endif
     /** The stream's current configuration. */
     PDMAUDIOSTREAMCFG       Cfg; //+108
@@ -1182 +1182 @@
  * buffer.
  *
- * @param   pStreamR3       HDA stream to update (ring-3 bits).
+ * @param   pStreamR3       The AC'97 stream (ring-3 bits).
  * @param   pSink           The mixer sink to pull from.
  */
@@ -1208 +1208 @@
  * Output streams: Pushes data to the mixer.
  *
- * @param   pStreamR3       HDA stream to update (ring-3 bits).
+ * @param   pStreamR3       The AC'97 stream (ring-3 bits).
  * @param   pSink           The mixer sink to push to.
  */
@@ -1359 +1359 @@
 
 /**
- * @callback_method_impl{FNRTTHREAD, Asynchronous I/O thread for an AC'97 stream.}
+ * @callback_method_impl{FNAUDMIXSINKUPDATE}
  *
  * For output streams this moves data from the internal DMA buffer (in which
@@ -3989 +3989 @@
     PDMDevHlpSTAMRegister(pDevIns, &pThis->StatBytesWritten, STAMTYPE_COUNTER, "BytesWritten", STAMUNIT_BYTES,          "Bytes written to AC97 emulation.");
 # endif
-    for (unsigned idxStream = 0; idxStream < RT_ELEMENTS(s_apszNames); idxStream++)
+    for (unsigned idxStream = 0; idxStream < RT_ELEMENTS(pThis->aStreams); idxStream++)
     {
         PDMDevHlpSTAMRegisterF(pDevIns, &pThisCC->aStreams[idxStream].State.offRead, STAMTYPE_U64, STAMVISIBILITY_USED, STAMUNIT_BYTES,
@@ -3999 +3999 @@
         PDMDevHlpSTAMRegisterF(pDevIns, &pThisCC->aStreams[idxStream].State.StatDmaBufUsed, STAMTYPE_U32, STAMVISIBILITY_USED, STAMUNIT_BYTES,
                                "Number of bytes used in the internal DMA buffer.",  "Stream%u/DMABufUsed", idxStream);
-
     }