Changeset 65565 in vbox for trunk/include/VBox

Timestamp:

Feb 1, 2017 2:11:10 PM (8 years ago)

Author:

vboxsync

Message:

Audio: Make use of pvBuf/cbBuf parameters in PDMIHOSTAUDIO::pfnStreamPlay() and PDMIHOSTAUDIO::pfnStreamCapture() to further abstract the backends from the audio connector. The backends now won't be allowed to operate on the audio connector's mixing buffers directly anymore that way.

File:

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

trunk/include/VBox/vmm/pdmaudioifs.h

@@ -441 +441 @@
 } PDMAUDIOPCMPROPS, *PPDMAUDIOPCMPROPS;
 
+/** Converts (audio) samples to bytes. */
+#define PDMAUDIOPCMPROPS_S2B(pProps, samples) ((samples) << (pProps)->cShift)
+/** Converts bytes to (audio) samples. */
+#define PDMAUDIOPCMPROPS_B2S(pProps, cb)  (cb >> (pProps)->cShift)
+
 /**
  * Audio volume parameters.
@@ -1168 +1173 @@
      * @param   pInterface          Pointer to the interface structure containing the called function pointer.
      * @param   pStream             Pointer to audio stream.
-     * @param   pvBuf               Pointer to audio data buffer to play.  Currently not used and must be NULL.
-     * @param   cbBuf               Size (in bytes) of audio data buffer.  Currently not used and must be 0.
+     * @param   pvBuf               Pointer to audio data buffer to play.
+     * @param   cbBuf               Size (in bytes) of audio data buffer.
      * @param   pcbWritten          Returns number of bytes written.  Optional.
      */
@@ -1180 +1185 @@
      * @param   pInterface          Pointer to the interface structure containing the called function pointer.
      * @param   pStream             Pointer to audio stream.
-     * @param   pvBuf               Buffer where to store read audio data.  Currently not used and must be NULL.
-     * @param   cbBuf               Size (in bytes) of buffer.  Currently not used and must be 0.
+     * @param   pvBuf               Buffer where to store read audio data.
+     * @param   cbBuf               Size (in bytes) of buffer.
      * @param   pcbRead             Returns number of bytes read.  Optional.
      */