diff options
| author | Daniel Rugerio <[email protected]> | 2019-06-28 16:08:54 -0700 |
|---|---|---|
| committer | Adonais Romero González <[email protected]> | 2019-06-28 16:08:54 -0700 |
| commit | 8ffcdad009e4d410f92fabc4e322a76a0be3a69d (patch) | |
| tree | 378b2d98a4210c61e2bc34f5b8959e87e4be5c6c /audio/sysvad/README.md | |
| parent | 75b2290f2a4ece68739d07135d352cdfec3a9e89 (diff) | |
Update audio samples (#387)
* Update SysVAD public sample.
* Add WaveTest public sample.
Diffstat (limited to 'audio/sysvad/README.md')
| -rw-r--r-- | audio/sysvad/README.md | 18 |
1 files changed, 12 insertions, 6 deletions
diff --git a/audio/sysvad/README.md b/audio/sysvad/README.md index 0170087b..5a31ab12 100644 --- a/audio/sysvad/README.md +++ b/audio/sysvad/README.md @@ -17,7 +17,8 @@ urlFragment: sysvad-virtual-audio-device-driver-sample samplefwlink: http://go.microsoft.com/fwlink/p/?LinkId=620183 ---> -# SysVAD Virtual Audio Device Driver Sample +SysVAD Virtual Audio Device Driver Sample +======================================== The Microsoft SysVAD Virtual Audio Device Driver (SYSVAD) shows how to develop a WDM audio driver that exposes support for multiple audio devices. @@ -36,11 +37,14 @@ Directory | Description TabletAudioSample | Endpoints that are present in TabletAudioSample driver. PhoneAudioSample | Endpoints that are present in PhoneAudioSample driver. EndpointsCommon | Endpoints that are present in both TabletAudioSample and PhoneAudioSample. It also contains other common code shared by both sample drivers. -SwapAPO | Sample APO. +SwapAPO | Sample APO that installs onto endpoints exposed by the SysVAD sample driver and swaps the left and right channels. +DelayAPO | Sample APO that adds a delay to the input samples. +KwsAPO | Sample APO that uses KSPROPERTY_INTERLEAVEDAUDIO_FORMATINFORMATION to determine if the keyword spotter pin is interleaving loopback audio with the microphone audio and identify which channels contain loopback audio. If it is interleaved the APO will strip out the loopback audio and deliver only the microphone audio upstream. Because channel data is removed, the APO negotiates an output format which is different than the input format. KeywordDetectorAdapter | Sample Keyword Detector Adapter. For more information about the Windows audio engine, see [Exposing Hardware-Offloaded Audio Processing in Windows](http://msdn.microsoft.com/en-us/windows/hardware/br259116), and note that audio hardware that is offload-capable replicates the architecture that is presented in the diagram shown in the topic. + Build the sample ---------------- @@ -52,11 +56,11 @@ Perform the following steps to build this sample driver. In Microsoft Visual Studio, Click **File** \> **Open** \> **Project/Solution...** and navigate to the folder that contains the sample files (for example, *C:\Windows-driver-samples\audio\sysvad*). Double-click the *sysvad* solution file. -In Visual Studio locate the Solution Explorer. (If this is not already open, choose **Solution Explorer** from the **View** menu.) In Solution Explorer, you can see one solution that has four projects. +In Visual Studio locate the Solution Explorer. (If this is not already open, choose **Solution Explorer** from the **View** menu.) In Solution Explorer, you can see one solution that has eight projects. **2. Set the sample's configuration and platform** -In Solution Explorer, right-click **Solution 'sysvad' (4 projects)**, and choose **Configuration Manager**. Make sure that the configuration and platform settings are the same for the four projects. By default, the configuration is set to **Debug**, and the platform is set to **Win32** for all the projects. If you make any configuration and/or platform changes for one project, you must make the same changes for the remaining three projects. +In Solution Explorer, right-click **Solution 'sysvad' (8 projects)**, and choose **Configuration Manager**. Make sure that the configuration and platform settings are the same for the eight projects. By default, the configuration is set to **Debug**, and the platform is set to **Win32** for all the projects. If you make any configuration and/or platform changes for one project, you must make the same changes for the remaining three projects. **3. Build the sample using Visual Studio** @@ -73,8 +77,9 @@ The package should contain these files: File | Description -----|------------ TabletAudioSample.sys OR PhoneAudioSample.sys| The driver file. -SwapAPO.dll | A sample APO. -DelayAPO.dll | A sample APO. +SwapAPO.dll | The swap APO. +DelayAPO.dll | The delay APO. +KWSApo.dll | The KWS APO. sysvad.cat | A signed catalog file, which serves as the signature for the entire package. TabletAudioSample.inf | An information (INF) file that contains information needed to install the driver. PhoneAudioSample.inf | An information (INF) file that contains information needed to install the driver. @@ -166,3 +171,4 @@ On the target computer, in a Command Prompt window, enter **devmgmt** to open De On the target computer, open Control Panel and navigate to **Hardware and Sound** \> **Manage audio devices**. In the Sound dialog box, select the speaker icon labeled as *Microsoft Virtual Audio Device (WDM) - Tablet Audio Sample*, then click **Set Default**, but do not click **OK**. This will keep the Sound dialog box open. Locate an MP3 or other audio file on the target computer and double-click to play it. Then in the Sound dialog box, verify that there is activity in the volume level indicator associated with the *Microsoft Virtual Audio Device (WDM) - Tablet Audio Sample* driver. + |
