2.0.7

CUETools.Codecs.CoreAudio/CoreAudioApi/AudioEndpointVolume.cs

@@ -0,0 +1,211 @@
+/*
+  LICENSE
+  -------
+  Copyright (C) 2007 Ray Molenkamp
+
+  This source code is provided 'as-is', without any express or implied
+  warranty.  In no event will the authors be held liable for any damages
+  arising from the use of this source code or the software it produces.
+
+  Permission is granted to anyone to use this source code for any purpose,
+  including commercial applications, and to alter it and redistribute it
+  freely, subject to the following restrictions:
+
+  1. The origin of this source code must not be misrepresented; you must not
+     claim that you wrote the original source code.  If you use this source code
+     in a product, an acknowledgment in the product documentation would be
+     appreciated but is not required.
+  2. Altered source versions must be plainly marked as such, and must not be
+     misrepresented as being the original source code.
+  3. This notice may not be removed or altered from any source distribution.
+*/
+
+using System;
+using System.Collections.Generic;
+using System.Text;
+using NAudio.CoreAudioApi.Interfaces;
+using System.Runtime.InteropServices;
+
+namespace NAudio.CoreAudioApi
+{
+    /// <summary>
+    /// Audio Endpoint Volume
+    /// </summary>
+    public class AudioEndpointVolume : IDisposable
+    {
+        private IAudioEndpointVolume _AudioEndPointVolume;
+        private AudioEndpointVolumeChannels _Channels;
+        private AudioEndpointVolumeStepInformation _StepInformation;
+        private AudioEndpointVolumeVolumeRange _VolumeRange;
+        private EEndpointHardwareSupport _HardwareSupport;
+        private AudioEndpointVolumeCallback _CallBack;
+
+        /// <summary>
+        /// On Volume Notification
+        /// </summary>
+        public event AudioEndpointVolumeNotificationDelegate OnVolumeNotification;
+
+        /// <summary>
+        /// Volume Range
+        /// </summary>
+        public AudioEndpointVolumeVolumeRange VolumeRange
+        {
+            get
+            {
+                return _VolumeRange;
+            }
+        }
+
+        /// <summary>
+        /// Hardware Support
+        /// </summary>
+        public EEndpointHardwareSupport HardwareSupport
+        {
+            get
+            {
+                return _HardwareSupport;
+            }
+        }
+
+        /// <summary>
+        /// Step Information
+        /// </summary>
+        public AudioEndpointVolumeStepInformation StepInformation
+        {
+            get
+            {
+                return _StepInformation;
+            }
+        }
+
+        /// <summary>
+        /// Channels
+        /// </summary>
+        public AudioEndpointVolumeChannels Channels
+        {
+            get
+            {
+                return _Channels;
+            }
+        }
+
+        /// <summary>
+        /// Master Volume Level
+        /// </summary>
+        public float MasterVolumeLevel
+        {
+            get
+            {
+                float result;
+                Marshal.ThrowExceptionForHR(_AudioEndPointVolume.GetMasterVolumeLevel(out result));
+                return result;
+            }
+            set
+            {
+                Marshal.ThrowExceptionForHR(_AudioEndPointVolume.SetMasterVolumeLevel(value, Guid.Empty));
+            }
+        }
+
+        /// <summary>
+        /// Master Volume Level Scalar
+        /// </summary>
+        public float MasterVolumeLevelScalar
+        {
+            get
+            {
+                float result;
+                Marshal.ThrowExceptionForHR(_AudioEndPointVolume.GetMasterVolumeLevelScalar(out result));
+                return result;
+            }
+            set
+            {
+                Marshal.ThrowExceptionForHR(_AudioEndPointVolume.SetMasterVolumeLevelScalar(value, Guid.Empty));
+            }
+        }
+
+        /// <summary>
+        /// Mute
+        /// </summary>
+        public bool Mute
+        {
+            get
+            {
+                bool result;
+                Marshal.ThrowExceptionForHR(_AudioEndPointVolume.GetMute(out result));
+                return result;
+            }
+            set
+            {
+                Marshal.ThrowExceptionForHR(_AudioEndPointVolume.SetMute(value, Guid.Empty));
+            }
+        }
+
+        /// <summary>
+        /// Volume Step Up
+        /// </summary>
+        public void VolumeStepUp()
+        {
+            Marshal.ThrowExceptionForHR(_AudioEndPointVolume.VolumeStepUp(Guid.Empty));
+        }
+
+        /// <summary>
+        /// Volume Step Down
+        /// </summary>
+        public void VolumeStepDown()
+        {
+            Marshal.ThrowExceptionForHR(_AudioEndPointVolume.VolumeStepDown(Guid.Empty));
+        }
+
+        /// <summary>
+        /// Creates a new Audio endpoint volume
+        /// </summary>
+        /// <param name="realEndpointVolume">IAudioEndpointVolume COM interface</param>
+        internal AudioEndpointVolume(IAudioEndpointVolume realEndpointVolume)
+        {
+            uint HardwareSupp;
+
+            _AudioEndPointVolume = realEndpointVolume;
+            _Channels = new AudioEndpointVolumeChannels(_AudioEndPointVolume);
+            _StepInformation = new AudioEndpointVolumeStepInformation(_AudioEndPointVolume);
+            Marshal.ThrowExceptionForHR(_AudioEndPointVolume.QueryHardwareSupport(out HardwareSupp));
+            _HardwareSupport = (EEndpointHardwareSupport)HardwareSupp;
+            _VolumeRange = new AudioEndpointVolumeVolumeRange(_AudioEndPointVolume);
+            _CallBack = new AudioEndpointVolumeCallback(this);
+            Marshal.ThrowExceptionForHR(_AudioEndPointVolume.RegisterControlChangeNotify(_CallBack));
+        }
+        internal void FireNotification(AudioVolumeNotificationData NotificationData)
+        {
+            AudioEndpointVolumeNotificationDelegate del = OnVolumeNotification;
+            if (del != null)
+            {
+                del(NotificationData);
+            }
+        }
+        #region IDisposable Members
+
+        /// <summary>
+        /// Dispose
+        /// </summary>
+        public void Dispose()
+        {
+            if (_CallBack != null)
+            {
+                Marshal.ThrowExceptionForHR(_AudioEndPointVolume.UnregisterControlChangeNotify(_CallBack));
+                _CallBack = null;
+            }
+            GC.SuppressFinalize(this);
+
+        }
+        
+        /// <summary>
+        /// Finalizer
+        /// </summary>
+        ~AudioEndpointVolume()
+        {
+            Dispose();
+        }
+
+        #endregion
+
+    }
+}