Changeset 68076 in vbox

Timestamp:

Jul 21, 2017 10:02:51 AM (7 years ago)

Author:

vboxsync

Message:

Audio: Implemented optional callbacks StreamPlayBegin / StreamPlayEnd + StreamCaptureBegin / StreamCaptureEnd. Not (yet) used but handy to have.

Location:

trunk

Files:

• include/VBox/vmm/pdmaudioifs.h (modified) (3 diffs)
• src/VBox/Devices/Audio/DrvAudio.cpp (modified) (4 diffs)

trunk/include/VBox/vmm/pdmaudioifs.h

@@ -1213 +1213 @@
 
     /**
+     * Signals the backend that the host wants to begin playing for this iteration. Optional.
+     *
+     * @param   pInterface          Pointer to the interface structure containing the called function pointer.
+     * @param   pStream             Pointer to audio stream.
+     */
+    DECLR3CALLBACKMEMBER(void, pfnStreamPlayBegin, (PPDMIHOSTAUDIO pInterface, PPDMAUDIOBACKENDSTREAM pStream));
+
+    /**
      * Plays (writes to) an audio (output) stream.
      *
@@ -1225 +1233 @@
 
     /**
+     * Signals the backend that the host finished playing for this iteration. Optional.
+     *
+     * @param   pInterface          Pointer to the interface structure containing the called function pointer.
+     * @param   pStream             Pointer to audio stream.
+     */
+    DECLR3CALLBACKMEMBER(void, pfnStreamPlayEnd, (PPDMIHOSTAUDIO pInterface, PPDMAUDIOBACKENDSTREAM pStream));
+
+    /**
+     * Signals the backend that the host wants to begin capturing for this iteration. Optional.
+     *
+     * @param   pInterface          Pointer to the interface structure containing the called function pointer.
+     * @param   pStream             Pointer to audio stream.
+     */
+    DECLR3CALLBACKMEMBER(void, pfnStreamCaptureBegin, (PPDMIHOSTAUDIO pInterface, PPDMAUDIOBACKENDSTREAM pStream));
+
+    /**
      * Captures (reads from) an audio (input) stream.
      *
@@ -1236 +1260 @@
     DECLR3CALLBACKMEMBER(int, pfnStreamCapture, (PPDMIHOSTAUDIO pInterface, PPDMAUDIOBACKENDSTREAM pStream, void *pvBuf, uint32_t cbBuf, uint32_t *pcbRead));
 
+    /**
+     * Signals the backend that the host finished capturing for this iteration. Optional.
+     *
+     * @param   pInterface          Pointer to the interface structure containing the called function pointer.
+     * @param   pStream             Pointer to audio stream.
+     */
+    DECLR3CALLBACKMEMBER(void, pfnStreamCaptureEnd, (PPDMIHOSTAUDIO pInterface, PPDMAUDIOBACKENDSTREAM pStream));
+
 } PDMIHOSTAUDIO;
 
 /** PDMIHOSTAUDIO interface ID. */
-#define PDMIHOSTAUDIO_IID                           "12DF859E-416A-4332-9980-A049AC70D187"
+#define PDMIHOSTAUDIO_IID                           "378A5C7F-A45A-4B8B-C1DA-CB49E84894AA"
 
 /** @} */

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

@@ -1503 +1503 @@
         uint32_t csToPlay = AudioMixBufLive(&pHstStream->MixBuf);
 
+        if (pThis->pHostDrvAudio->pfnStreamPlayBegin)
+            pThis->pHostDrvAudio->pfnStreamPlayBegin(pThis->pHostDrvAudio, pHstStream->pvBackend);
+
         if (RT_LIKELY(pHstStream->Cfg.enmLayout == PDMAUDIOSTREAMLAYOUT_NON_INTERLEAVED))
         {
@@ -1513 +1516 @@
         else
             AssertFailedStmt(rc = VERR_NOT_IMPLEMENTED);
+
+        if (pThis->pHostDrvAudio->pfnStreamPlayEnd)
+            pThis->pHostDrvAudio->pfnStreamPlayEnd(pThis->pHostDrvAudio, pHstStream->pvBackend);
 
         uint32_t csLive = 0;
@@ -1789 +1795 @@
          */
 
+        if (pThis->pHostDrvAudio->pfnStreamCaptureBegin)
+            pThis->pHostDrvAudio->pfnStreamCaptureBegin(pThis->pHostDrvAudio, pHstStream->pvBackend);
+
         if (RT_LIKELY(pHstStream->Cfg.enmLayout == PDMAUDIOSTREAMLAYOUT_NON_INTERLEAVED))
         {
@@ -1799 +1808 @@
         else
             AssertFailedStmt(rc = VERR_NOT_IMPLEMENTED);
+
+        if (pThis->pHostDrvAudio->pfnStreamCaptureEnd)
+            pThis->pHostDrvAudio->pfnStreamCaptureEnd(pThis->pHostDrvAudio, pHstStream->pvBackend);
 
 #ifdef LOG_ENABLED