AudioSnifferInterface.cpp revision 174f3dff60f96d89b320f9a322307118676db1db
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * VirtualBox Driver Interface to Audio Sniffer device
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * Copyright (C) 2006-2012 Oracle Corporation
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * available from http://www.virtualbox.org. This file is free software;
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * you can redistribute it and/or modify it under the terms of the GNU
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * General Public License (GPL) as published by the Free Software
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
040b4a09341f574825386333398110f4db3e1e51vboxsync * Audio Sniffer driver instance data.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * @extends PDMIAUDIOSNIFFERCONNECTOR
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /** Pointer to the Audio Sniffer object. */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /** Pointer to the driver instance structure. */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /** Pointer to the AudioSniffer port interface of the driver/device above us. */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /** Our VMM device connector interface. */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync/** Converts PDMIAUDIOSNIFFERCONNECTOR pointer to a DRVAUDIOSNIFFER pointer. */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync#define PDMIAUDIOSNIFFERCONNECTOR_2_MAINAUDIOSNIFFER(pInterface) RT_FROM_MEMBER(pInterface, DRVAUDIOSNIFFER, Connector)
040b4a09341f574825386333398110f4db3e1e51vboxsync// constructor / destructor
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsyncPPDMIAUDIOSNIFFERPORT AudioSniffer::getAudioSnifferPort()
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync// public methods
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsyncDECLCALLBACK(void) iface_AudioSamplesOut (PPDMIAUDIOSNIFFERCONNECTOR pInterface, void *pvSamples, uint32_t cSamples,
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync int samplesPerSec, int nChannels, int bitsPerSample, bool fUnsigned)
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync PDRVAUDIOSNIFFER pDrv = PDMIAUDIOSNIFFERCONNECTOR_2_MAINAUDIOSNIFFER(pInterface);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * Just call the VRDP server with the data.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync VRDEAUDIOFORMAT format = VRDE_AUDIO_FMT_MAKE(samplesPerSec, nChannels, bitsPerSample, !fUnsigned);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync pDrv->pAudioSniffer->getParent()->i_consoleVRDPServer()->SendAudioSamples(pvSamples, cSamples, format);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsyncDECLCALLBACK(void) iface_AudioVolumeOut (PPDMIAUDIOSNIFFERCONNECTOR pInterface, uint16_t left, uint16_t right)
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync PDRVAUDIOSNIFFER pDrv = PDMIAUDIOSNIFFERCONNECTOR_2_MAINAUDIOSNIFFER(pInterface);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * Just call the VRDP server with the data.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync pDrv->pAudioSniffer->getParent()->i_consoleVRDPServer()->SendAudioVolume(left, right);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsyncDECLCALLBACK(int) iface_AudioInputBegin (PPDMIAUDIOSNIFFERCONNECTOR pInterface,
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync PDRVAUDIOSNIFFER pDrv = PDMIAUDIOSNIFFERCONNECTOR_2_MAINAUDIOSNIFFER(pInterface);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync return pDrv->pAudioSniffer->getParent()->i_consoleVRDPServer()->SendAudioInputBegin(ppvUserCtx,
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsyncDECLCALLBACK(void) iface_AudioInputEnd (PPDMIAUDIOSNIFFERCONNECTOR pInterface,
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync PDRVAUDIOSNIFFER pDrv = PDMIAUDIOSNIFFERCONNECTOR_2_MAINAUDIOSNIFFER(pInterface);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync pDrv->pAudioSniffer->getParent()->i_consoleVRDPServer()->SendAudioInputEnd(pvUserCtx);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * @interface_method_impl{PDMIBASE,pfnQueryInterface}
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsyncDECLCALLBACK(void *) AudioSniffer::drvQueryInterface(PPDMIBASE pInterface, const char *pszIID)
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync PPDMDRVINS pDrvIns = PDMIBASE_2_PDMDRV(pInterface);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync PDRVAUDIOSNIFFER pDrv = PDMINS_2_DATA(pDrvIns, PDRVAUDIOSNIFFER);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync PDMIBASE_RETURN_INTERFACE(pszIID, PDMIBASE, &pDrvIns->IBase);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync PDMIBASE_RETURN_INTERFACE(pszIID, PDMIAUDIOSNIFFERCONNECTOR, &pDrv->Connector);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * Destruct a Audio Sniffer driver instance.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * @returns VBox status.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * @param pDrvIns The driver instance data.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsyncDECLCALLBACK(void) AudioSniffer::drvDestruct(PPDMDRVINS pDrvIns)
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync PDRVAUDIOSNIFFER pThis = PDMINS_2_DATA(pDrvIns, PDRVAUDIOSNIFFER);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync LogFlow(("AudioSniffer::drvDestruct: iInstance=%d\n", pDrvIns->iInstance));
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * Construct a AudioSniffer driver instance.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * @copydoc FNPDMDRVCONSTRUCT
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsyncDECLCALLBACK(int) AudioSniffer::drvConstruct(PPDMDRVINS pDrvIns, PCFGMNODE pCfg, uint32_t fFlags)
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync PDRVAUDIOSNIFFER pThis = PDMINS_2_DATA(pDrvIns, PDRVAUDIOSNIFFER);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync LogFlow(("AudioSniffer::drvConstruct: iInstance=%d\n", pDrvIns->iInstance));
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * Validate configuration.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync AssertMsgReturn(PDMDrvHlpNoAttach(pDrvIns) == VERR_PDM_NO_ATTACHED_DRIVER,
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync ("Configuration error: Not possible to attach anything to this driver!\n"),
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync pDrvIns->IBase.pfnQueryInterface = AudioSniffer::drvQueryInterface;
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* Audio Sniffer connector. */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync pThis->Connector.pfnAudioSamplesOut = iface_AudioSamplesOut;
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync pThis->Connector.pfnAudioVolumeOut = iface_AudioVolumeOut;
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync pThis->Connector.pfnAudioInputBegin = iface_AudioInputBegin;
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync pThis->Connector.pfnAudioInputEnd = iface_AudioInputEnd;
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * Get the Audio Sniffer Port interface of the above driver/device.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync pThis->pUpPort = PDMIBASE_QUERY_INTERFACE(pDrvIns->pUpBase, PDMIAUDIOSNIFFERPORT);
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync AssertMsgFailed(("Configuration error: No Audio Sniffer port interface above!\n"));
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * Get the Console object pointer and update the mpDrv member.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync AssertMsgFailed(("Configuration error: No/bad \"Object\" value! rc=%Rrc\n", rc));
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync pThis->pAudioSniffer = (AudioSniffer *)pv; /** @todo Check this cast! */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync * Audio Sniffer driver registration record.
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* u32Version */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* szName */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync "MainAudioSniffer",
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* szRCMod */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* szR0Mod */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pszDescription */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync "Main Audio Sniffer driver (Main as in the API).",
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* fFlags */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* fClass. */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* cMaxInstances */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* cbInstance */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnConstruct */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnDestruct */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnRelocate */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnIOCtl */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnPowerOn */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnReset */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnSuspend */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnResume */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnAttach */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnDetach */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnPowerOff */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* pfnSoftReset */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync /* u32EndVersion */
589fd26cedb2b4ebbed14f2964cad03cc8ebbca2vboxsync/* vi: set tabstop=4 shiftwidth=4 expandtab: */