Click here to Skip to main content
Click here to Skip to main content

Vista Core Audio API Master Volume Control

, 3 May 2012
Rate this:
Please Sign up or sign in to vote.
A managed wrapper for accessing the Vista Core Audio API
Screenshot - CoreAudioVolume.png

Introduction

Windows Vista features a completely new set of user-mode audio components that provide per application volume control. All legacy APIs such as the waveXxx and mixerXxx functions and DirectSound have been rebuilt on top of these new components so that without any code changes all 'old' applications support this new audio API. This is a great thing except when your application is reading or querying the master volume settings of the operating system because all of a sudden, you are no longer controlling the master volume of the operating system but only of your own application.

Core Audio API

The new API is COM based, and split into four sub APIs which roughly do the following:

  • MMDevice API - This API allows enumeration and instancing of the available audio devices in the system.
  • WASAPI - This API allows playback and recording of audio streams.
  • DeviceTopology API - This API allows access to hardware features such as bass, treble, and auto gain control.
  • EndpointVolume API - This API allows access to the Volume and Peak meters.

The MMDevice and EndpointVolume APIs are needed to control the master volume and mute settings, while the APIs themselves are a huge improvement since the legacy functions lack a nice managed interface, making working with them somehow an unpleasant experience in C#. Writing COM interop code is not for the novice and is error-prone, hence creating a wrapper to do all the plumbing for us seems a good idea.

Using the Code

You always start by creating the enumerator class, allowing you to find the device that you want, or just settle for the default device.

MMDeviceEnumerator devEnum = new MMDeviceEnumerator();
MMDevice defaultDevice = 
  devEnum.GetDefaultAudioEndpoint(EDataFlow.eRender, ERole.eMultimedia);

After you have a reference to an MMDevice object, toggling Mute is as easy as:

defaultDevice.AudioEndpointVolume.Mute = 
             !defaultDevice.AudioEndpointVolume.Mute;

Or getting the volume of the left channel:

Console.WriteLine("Left Volume : {0}", 
      defaultDevice.AudioEndpointVolume.Channels[0].VolumeLevelScalar);

Since the wrapper implements the complete EndpointVolume API, we can also get more advanced things such as peak meters for all channels:

Console.WriteLine("Master Peak : {0}", 
      defaultDevice.AudioMeterInformation.MasterPeakValue);
Console.WriteLine("Left   Peak : {0}", 
      defaultDevice.AudioMeterInformation.PeakValues[0]);
Console.WriteLine("Right  Peak : {0}", 
      defaultDevice.AudioMeterInformation.PeakValues[1]);

If you just want to be informed when somebody changes the volume settings, you can subscribe to the OnVolumeNotification event like this:

defaultDevice.AudioEndpointVolume.OnVolumeNotification += new 
    AudioEndpointVolumeNotificationDelegate(
       AudioEndpointVolume_OnVolumeNotification);
.
.
void AudioEndpointVolume_OnVolumeNotification(AudioVolumeNotificationData data)
{
    Console.WriteLine("New Volume {0}", data.MasterVolume);
    Console.WriteLine("Muted      {0}", data.Muted);
}

Points of interest

The documentation of the volume notification states it must be non-blocking. The client should never wait on a synchronization object during an event callback. Keep that in mind when write event handlers.

Although Vista does per-application audio settings, Microsoft has not open up the APIs to enumerate Sessions. So it will not be possible to make a sndvol.exe-like application.

Right now, only the MMDevice and EndpointVolume APIs are implemented; I hope to add the WASAPI in a future update.

History

  • 2007.04.23 - Initial article
  • 2010.05.17 - Updated source and sample

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Ray M.
Web Developer
Netherlands Netherlands
No Biography provided

Comments and Discussions

 
QuestionExcelente!! PinmemberLeonardo Lynx26-Jul-14 16:20 
QuestionMemory Leaks [modified] PinmemberYanRaf27-Feb-14 6:26 
QuestionSemaphore COMexception when i trying to change MasterVolumeLevelScalar or AudioEndpointVolume.Mute of microphone Pinmemberjstq26-Feb-14 7:11 
QuestionMutes all processes except spotify and system-volume- Pinmemberbradapfel23-Dec-13 12:59 
QuestionHow i mute the subunit(IPart) of the defauld Render device? PinmemberMember 1042324025-Nov-13 11:20 
BugMarshalAs string : wrong type, access violation Pinmemberjulienvary18-Sep-13 4:44 
QuestionIs it possible to monitor an audio jack? PinmemberVekool_Coder1-Sep-13 2:03 
Question“The calling thread must be STA" Pinmemberankit_sam3-Jul-13 14:19 
QuestionHow can i use this in VB.net to get the "AudioMeterInformation.MasterPeakValue" Pinmember3AgL3 DeeJay26-Apr-13 12:09 
AnswerRe: How can i use this in VB.net to get the "AudioMeterInformation.MasterPeakValue" Pinmember3AgL3 DeeJay27-Apr-13 9:03 
GeneralRe: How can i use this in VB.net to get the "AudioMeterInformation.MasterPeakValue" PinmemberMember 1017462928-Aug-13 6:27 
GeneralRe: How can i use this in VB.net to get the "AudioMeterInformation.MasterPeakValue" Pinmember3AgL3 DeeJay28-Aug-13 9:22 
QuestionFollowing Code Cannot Run In Background Pinmemberq1139600966-Apr-13 14:07 
GeneralMy vote of 5 PinmemberSergio Andrés Gutiérrez Rojas29-Mar-13 13:46 
Questionhi Pinmembernmuhammad15-Mar-13 22:23 
GeneralMy vote of 5 Pinmemberbachtkb11-Feb-13 17:49 
GeneralMy vote of 3 Pinmemberjason.leex15-Jan-13 16:01 
GeneralMy vote of 5 PinmemberEdo Tzumer8-Jan-13 20:25 
QuestionIs Good Pinmemberisisbrand7-Jan-13 3:02 
GeneralMy vote of 5 Pinmembersir-West27-Dec-12 23:37 
QuestionWhy the files i downloaded is broken? PinmemberLoveIn_LIn21-Nov-12 15:23 
i cannot unzip the file,there's a error when i unzip it."cannot found the compression document"
please help me..
QuestionHow can I select the app in "CoreAudioConsoleTest" PinmemberMember 94111563-Nov-12 8:16 
QuestionPeak meter level for a capture endpoint always 0.0 unless Microsoft recording panel is open Pinmemberunpocoloco2-Nov-12 15:36 
QuestionHow to implement IMMNotificationClient Pinmemberkhoonking26-Sep-12 23:29 
AnswerRe: How to implement IMMNotificationClient Pinmemberimaginejta6-Jan-13 3:07 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web01 | 2.8.140721.1 | Last Updated 3 May 2012
Article Copyright 2007 by Ray M.
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid