Changeset 64508 in vbox for trunk/src/VBox/Devices/Audio/DrvHostValidationKit.cpp

Timestamp:

Nov 1, 2016 2:48:42 PM (8 years ago)

Author:

vboxsync

Message:

Audio: Added Validation Kit skeleton driver. Use with VBOX_WITH_AUDIO_VALIDATIONKIT set. Needs to be modifiable at runtime later.

File:

• trunk/src/VBox/Devices/Audio/DrvHostValidationKit.cpp (copied) (copied from trunk/src/VBox/Devices/Audio/DrvHostDebugAudio.cpp ) (24 diffs)

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

@@ -1 +1 @@
 /* $Id$ */
 /** @file
- * Debug audio driver -- host backend for dumping and injecting audio data
- * from/to the device emulation.
+ * Validation Kit audio driver.
  */
 
@@ -33 +32 @@
  * Structure for keeping a debug input/output stream.
  */
-typedef struct DEBUGAUDIOSTREAM
+typedef struct VAKITAUDIOSTREAM
 {
     /** Note: Always must come first! */
@@ -55 +54 @@
     };
 
-} DEBUGAUDIOSTREAM, *PDEBUGAUDIOSTREAM;
-
-/**
- * Debug audio driver instance data.
+} VAKITAUDIOSTREAM, *PVAKITAUDIOSTREAM;
+
+/**
+ * Validation Kit audio driver instance data.
  * @implements PDMIAUDIOCONNECTOR
  */
-typedef struct DRVHOSTDEBUGAUDIO
+typedef struct DRVHOSTVAKITAUDIO
 {
     /** Pointer to the driver instance structure. */
@@ -67 +66 @@
     /** Pointer to host audio interface. */
     PDMIHOSTAUDIO IHostAudio;
-} DRVHOSTDEBUGAUDIO, *PDRVHOSTDEBUGAUDIO;
+} DRVHOSTVAKITAUDIO, *PDRVHOSTVAKITAUDIO;
 
 /*******************************************PDM_AUDIO_DRIVER******************************/
@@ -75 +74 @@
  * @interface_method_impl{PDMIHOSTAUDIO,pfnGetConfig}
  */
-static DECLCALLBACK(int) drvHostDebugAudioGetConfig(PPDMIHOSTAUDIO pInterface, PPDMAUDIOBACKENDCFG pBackendCfg)
+static DECLCALLBACK(int) drvHostVaKitAudioGetConfig(PPDMIHOSTAUDIO pInterface, PPDMAUDIOBACKENDCFG pBackendCfg)
 {
     NOREF(pInterface);
     AssertPtrReturn(pBackendCfg, VERR_INVALID_POINTER);
 
-    pBackendCfg->cbStreamOut    = sizeof(DEBUGAUDIOSTREAM);
-    pBackendCfg->cbStreamIn     = sizeof(DEBUGAUDIOSTREAM);
+    pBackendCfg->cbStreamOut    = sizeof(VAKITAUDIOSTREAM);
+    pBackendCfg->cbStreamIn     = sizeof(VAKITAUDIOSTREAM);
 
     pBackendCfg->cMaxStreamsOut = 1; /* Output */
@@ -93 +92 @@
  * @interface_method_impl{PDMIHOSTAUDIO,pfnInit}
  */
-static DECLCALLBACK(int) drvHostDebugAudioInit(PPDMIHOSTAUDIO pInterface)
+static DECLCALLBACK(int) drvHostVaKitAudioInit(PPDMIHOSTAUDIO pInterface)
 {
     NOREF(pInterface);
@@ -105 +104 @@
  * @interface_method_impl{PDMIHOSTAUDIO,pfnShutdown}
  */
-static DECLCALLBACK(void) drvHostDebugAudioShutdown(PPDMIHOSTAUDIO pInterface)
+static DECLCALLBACK(void) drvHostVaKitAudioShutdown(PPDMIHOSTAUDIO pInterface)
 {
     NOREF(pInterface);
@@ -114 +113 @@
  * @interface_method_impl{PDMIHOSTAUDIO,pfnGetStatus}
  */
-static DECLCALLBACK(PDMAUDIOBACKENDSTS) drvHostDebugAudioGetStatus(PPDMIHOSTAUDIO pInterface, PDMAUDIODIR enmDir)
+static DECLCALLBACK(PDMAUDIOBACKENDSTS) drvHostVaKitAudioGetStatus(PPDMIHOSTAUDIO pInterface, PDMAUDIODIR enmDir)
 {
     RT_NOREF(enmDir);
@@ -147 +146 @@
     NOREF(pInterface);
 
-    PDEBUGAUDIOSTREAM pDbgStream = (PDEBUGAUDIOSTREAM)pStream;
+    PVAKITAUDIOSTREAM pDbgStream = (PVAKITAUDIOSTREAM)pStream;
 
     /* Just adopt the wanted stream configuration. */
@@ -199 +198 @@
  * @interface_method_impl{PDMIHOSTAUDIO,pfnStreamCreate}
  */
-static DECLCALLBACK(int) drvHostDebugAudioStreamCreate(PPDMIHOSTAUDIO pInterface,
+static DECLCALLBACK(int) drvHostVaKitAudioStreamCreate(PPDMIHOSTAUDIO pInterface,
                                                        PPDMAUDIOSTREAM pStream,
                                                        PPDMAUDIOSTREAMCFG pCfgReq, PPDMAUDIOSTREAMCFG pCfgAcq)
@@ -221 +220 @@
  * @interface_method_impl{PDMIHOSTAUDIO,pfnStreamPlay}
  */
-static DECLCALLBACK(int) drvHostDebugAudioStreamPlay(PPDMIHOSTAUDIO pInterface,
+static DECLCALLBACK(int) drvHostVaKitAudioStreamPlay(PPDMIHOSTAUDIO pInterface,
                                                      PPDMAUDIOSTREAM pStream, const void *pvBuf, uint32_t cbBuf,
                                                      uint32_t *pcbWritten)
@@ -227 +226 @@
     RT_NOREF(pvBuf, cbBuf);
 
-    PDRVHOSTDEBUGAUDIO pDrv       = RT_FROM_MEMBER(pInterface, DRVHOSTDEBUGAUDIO, IHostAudio);
-    PDEBUGAUDIOSTREAM  pDbgStream = (PDEBUGAUDIOSTREAM)pStream;
+    PDRVHOSTVAKITAUDIO pDrv       = RT_FROM_MEMBER(pInterface, DRVHOSTVAKITAUDIO, IHostAudio);
+    PVAKITAUDIOSTREAM  pDbgStream = (PVAKITAUDIOSTREAM)pStream;
 
     /* Consume as many samples as would be played at the current frequency since last call. */
@@ -294 +293 @@
  * @interface_method_impl{PDMIHOSTAUDIO,pfnStreamCapture}
  */
-static DECLCALLBACK(int) drvHostDebugAudioStreamCapture(PPDMIHOSTAUDIO pInterface,
+static DECLCALLBACK(int) drvHostVaKitAudioStreamCapture(PPDMIHOSTAUDIO pInterface,
                                                         PPDMAUDIOSTREAM pStream, void *pvBuf, uint32_t cbBuf, uint32_t *pcbRead)
 {
@@ -318 +317 @@
 {
     RT_NOREF(pInterface);
-    PDEBUGAUDIOSTREAM pDbgStream = (PDEBUGAUDIOSTREAM)pStream;
+    PVAKITAUDIOSTREAM pDbgStream = (PVAKITAUDIOSTREAM)pStream;
     if (   pDbgStream
         && pDbgStream->Out.pu8PlayBuffer)
@@ -348 +347 @@
 
 
-static DECLCALLBACK(int) drvHostDebugAudioStreamDestroy(PPDMIHOSTAUDIO pInterface, PPDMAUDIOSTREAM pStream)
+static DECLCALLBACK(int) drvHostVaKitAudioStreamDestroy(PPDMIHOSTAUDIO pInterface, PPDMAUDIOSTREAM pStream)
 {
     AssertPtrReturn(pInterface, VERR_INVALID_POINTER);
@@ -362 +361 @@
 }
 
-static DECLCALLBACK(int) drvHostDebugAudioStreamControl(PPDMIHOSTAUDIO pInterface,
+static DECLCALLBACK(int) drvHostVaKitAudioStreamControl(PPDMIHOSTAUDIO pInterface,
                                                         PPDMAUDIOSTREAM pStream, PDMAUDIOSTREAMCMD enmStreamCmd)
 {
     RT_NOREF(enmStreamCmd);
+
     AssertPtrReturn(pInterface, VERR_INVALID_POINTER);
     AssertPtrReturn(pStream,    VERR_INVALID_POINTER);
@@ -374 +374 @@
 }
 
-static DECLCALLBACK(PDMAUDIOSTRMSTS) drvHostDebugAudioStreamGetStatus(PPDMIHOSTAUDIO pInterface, PPDMAUDIOSTREAM pStream)
+static DECLCALLBACK(PDMAUDIOSTRMSTS) drvHostVaKitAudioStreamGetStatus(PPDMIHOSTAUDIO pInterface, PPDMAUDIOSTREAM pStream)
 {
     NOREF(pInterface);
@@ -383 +383 @@
 }
 
-static DECLCALLBACK(int) drvHostDebugAudioStreamIterate(PPDMIHOSTAUDIO pInterface, PPDMAUDIOSTREAM pStream)
+static DECLCALLBACK(int) drvHostVaKitAudioStreamIterate(PPDMIHOSTAUDIO pInterface, PPDMAUDIOSTREAM pStream)
 {
     NOREF(pInterface);
@@ -395 +395 @@
  * @interface_method_impl{PDMIBASE,pfnQueryInterface}
  */
-static DECLCALLBACK(void *) drvHostDebugAudioQueryInterface(PPDMIBASE pInterface, const char *pszIID)
+static DECLCALLBACK(void *) drvHostVaKitAudioQueryInterface(PPDMIBASE pInterface, const char *pszIID)
 {
     PPDMDRVINS         pDrvIns = PDMIBASE_2_PDMDRV(pInterface);
-    PDRVHOSTDEBUGAUDIO pThis   = PDMINS_2_DATA(pDrvIns, PDRVHOSTDEBUGAUDIO);
+    PDRVHOSTVAKITAUDIO pThis   = PDMINS_2_DATA(pDrvIns, PDRVHOSTVAKITAUDIO);
 
     PDMIBASE_RETURN_INTERFACE(pszIID, PDMIBASE, &pDrvIns->IBase);
@@ -411 +411 @@
  * @copydoc FNPDMDRVCONSTRUCT
  */
-static DECLCALLBACK(int) drvHostDebugAudioConstruct(PPDMDRVINS pDrvIns, PCFGMNODE pCfg, uint32_t fFlags)
+static DECLCALLBACK(int) drvHostVaKitAudioConstruct(PPDMDRVINS pDrvIns, PCFGMNODE pCfg, uint32_t fFlags)
 {
     RT_NOREF(pCfg, fFlags);
     PDMDRV_CHECK_VERSIONS_RETURN(pDrvIns);
-    PDRVHOSTDEBUGAUDIO pThis = PDMINS_2_DATA(pDrvIns, PDRVHOSTDEBUGAUDIO);
-    LogRel(("Audio: Initializing DEBUG driver\n"));
+    PDRVHOSTVAKITAUDIO pThis = PDMINS_2_DATA(pDrvIns, PDRVHOSTVAKITAUDIO);
+    LogRel(("Audio: Initializing ValidationKit driver\n"));
 
     /*
@@ -423 +423 @@
     pThis->pDrvIns                   = pDrvIns;
     /* IBase */
-    pDrvIns->IBase.pfnQueryInterface = drvHostDebugAudioQueryInterface;
+    pDrvIns->IBase.pfnQueryInterface = drvHostVaKitAudioQueryInterface;
     /* IHostAudio */
-    PDMAUDIO_IHOSTAUDIO_CALLBACKS(drvHostDebugAudio);
+    PDMAUDIO_IHOSTAUDIO_CALLBACKS(drvHostVaKitAudio);
 
     return VINF_SUCCESS;
@@ -433 +433 @@
  * Char driver registration record.
  */
-const PDMDRVREG g_DrvHostDebugAudio =
+const PDMDRVREG g_DrvHostValidationKitAudio =
 {
     /* u32Version */
     PDM_DRVREG_VERSION,
     /* szName */
-    "DebugAudio",
+    "ValidationKit",
     /* szRCMod */
     "",
@@ -444 +444 @@
     "",
     /* pszDescription */
-    "Debug audio host driver",
+    "ValidationKit audio host driver",
     /* fFlags */
     PDM_DRVREG_FLAGS_HOST_BITS_DEFAULT,
@@ -450 +450 @@
     PDM_DRVREG_CLASS_AUDIO,
     /* cMaxInstances */
-    ~0U,
+    1,
     /* cbInstance */
-    sizeof(DRVHOSTDEBUGAUDIO),
+    sizeof(DRVHOSTVAKITAUDIO),
     /* pfnConstruct */
-    drvHostDebugAudioConstruct,
+    drvHostVaKitAudioConstruct,
     /* pfnDestruct */
     NULL,