// created on 10/12/2002 at 21:11 using System; using System.Runtime.InteropServices; using System.Collections.Generic; namespace NAudio.Mixer { /// /// Represents a mixer control /// public abstract class MixerControl { internal MixerInterop.MIXERCONTROL mixerControl; internal MixerInterop.MIXERCONTROLDETAILS mixerControlDetails; /// /// Mixer Handle /// protected IntPtr mixerHandle; /// /// Number of Channels /// protected int nChannels; /// /// Mixer Handle Type /// protected MixerFlags mixerHandleType; /// /// Gets all the mixer controls /// /// Mixer Handle /// Mixer Line /// Mixer Handle Type /// public static IList GetMixerControls(IntPtr mixerHandle, MixerLine mixerLine, MixerFlags mixerHandleType) { var controls = new List(); if (mixerLine.ControlsCount > 0) { int mixerControlSize = Marshal.SizeOf(typeof (MixerInterop.MIXERCONTROL)); var mlc = new MixerInterop.MIXERLINECONTROLS(); IntPtr pmc = Marshal.AllocHGlobal(mixerControlSize * mixerLine.ControlsCount); mlc.cbStruct = Marshal.SizeOf(mlc); mlc.dwLineID = mixerLine.LineId; mlc.cControls = mixerLine.ControlsCount; mlc.pamxctrl = pmc; mlc.cbmxctrl = Marshal.SizeOf(typeof(MixerInterop.MIXERCONTROL)); try { MmResult err = MixerInterop.mixerGetLineControls(mixerHandle, ref mlc, MixerFlags.All | mixerHandleType); if (err != MmResult.NoError) { throw new MmException(err, "mixerGetLineControls"); } for (int i = 0; i < mlc.cControls; i++) { Int64 address = pmc.ToInt64() + mixerControlSize * i; var mc = (MixerInterop.MIXERCONTROL) Marshal.PtrToStructure((IntPtr)address, typeof(MixerInterop.MIXERCONTROL)); var mixerControl = GetMixerControl(mixerHandle, mixerLine.LineId, mc.dwControlID, mixerLine.Channels, mixerHandleType); controls.Add(mixerControl); } } finally { Marshal.FreeHGlobal(pmc); } } return controls; } /// /// Gets a specified Mixer Control /// /// Mixer Handle /// Line ID /// Control ID /// Number of Channels /// Flags to use (indicates the meaning of mixerHandle) /// public static MixerControl GetMixerControl(IntPtr mixerHandle, int nLineID, int controlId, int nChannels, MixerFlags mixerFlags) { MixerInterop.MIXERLINECONTROLS mlc = new MixerInterop.MIXERLINECONTROLS(); MixerInterop.MIXERCONTROL mc = new MixerInterop.MIXERCONTROL(); // set up the pointer to a structure IntPtr pMixerControl = Marshal.AllocCoTaskMem(Marshal.SizeOf(mc)); //Marshal.StructureToPtr(mc, pMixerControl, false); mlc.cbStruct = Marshal.SizeOf(mlc); mlc.cControls = 1; mlc.dwControlID = controlId; mlc.cbmxctrl = Marshal.SizeOf(mc); mlc.pamxctrl = pMixerControl; mlc.dwLineID = nLineID; MmResult err = MixerInterop.mixerGetLineControls(mixerHandle, ref mlc, MixerFlags.OneById | mixerFlags); if (err != MmResult.NoError) { Marshal.FreeCoTaskMem(pMixerControl); throw new MmException(err, "mixerGetLineControls"); } // retrieve the structure from the pointer mc = (MixerInterop.MIXERCONTROL) Marshal.PtrToStructure(mlc.pamxctrl, typeof (MixerInterop.MIXERCONTROL)); Marshal.FreeCoTaskMem(pMixerControl); if (MixerControl.IsControlBoolean(mc.dwControlType)) { return new BooleanMixerControl(mc, mixerHandle, mixerFlags, nChannels); } else if (MixerControl.IsControlSigned(mc.dwControlType)) { return new SignedMixerControl(mc, mixerHandle, mixerFlags, nChannels); } else if (MixerControl.IsControlUnsigned(mc.dwControlType)) { return new UnsignedMixerControl(mc, mixerHandle, mixerFlags, nChannels); } else if (MixerControl.IsControlListText(mc.dwControlType)) { return new ListTextMixerControl(mc, mixerHandle, mixerFlags, nChannels); } else if (MixerControl.IsControlCustom(mc.dwControlType)) { return new CustomMixerControl(mc, mixerHandle, mixerFlags, nChannels); } else { throw new InvalidOperationException(String.Format("Unknown mixer control type {0}", mc.dwControlType)); } } /// /// Gets the control details /// protected void GetControlDetails() { mixerControlDetails.cbStruct = Marshal.SizeOf(mixerControlDetails); mixerControlDetails.dwControlID = mixerControl.dwControlID; if (IsCustom) { mixerControlDetails.cChannels = 0; } else if ((mixerControl.fdwControl & MixerInterop.MIXERCONTROL_CONTROLF_UNIFORM) != 0) { mixerControlDetails.cChannels = 1; } else { mixerControlDetails.cChannels = nChannels; } if ((mixerControl.fdwControl & MixerInterop.MIXERCONTROL_CONTROLF_MULTIPLE) != 0) { mixerControlDetails.hwndOwner = (IntPtr) mixerControl.cMultipleItems; } else if (IsCustom) { mixerControlDetails.hwndOwner = IntPtr.Zero; // TODO: special cases } else { mixerControlDetails.hwndOwner = IntPtr.Zero; } if (IsBoolean) { mixerControlDetails.cbDetails = Marshal.SizeOf(new MixerInterop.MIXERCONTROLDETAILS_BOOLEAN()); } else if (IsListText) { mixerControlDetails.cbDetails = Marshal.SizeOf(new MixerInterop.MIXERCONTROLDETAILS_LISTTEXT()); } else if (IsSigned) { mixerControlDetails.cbDetails = Marshal.SizeOf(new MixerInterop.MIXERCONTROLDETAILS_SIGNED()); } else if (IsUnsigned) { mixerControlDetails.cbDetails = Marshal.SizeOf(new MixerInterop.MIXERCONTROLDETAILS_UNSIGNED()); } else { // must be custom mixerControlDetails.cbDetails = mixerControl.Metrics.customData; } var detailsSize = mixerControlDetails.cbDetails*mixerControlDetails.cChannels; if ((mixerControl.fdwControl & MixerInterop.MIXERCONTROL_CONTROLF_MULTIPLE) != 0) { // fixing issue 16390 - calculating size correctly for multiple items detailsSize *= (int) mixerControl.cMultipleItems; } IntPtr buffer = Marshal.AllocCoTaskMem(detailsSize); // To copy stuff in: // Marshal.StructureToPtr( theStruct, buffer, false ); mixerControlDetails.paDetails = buffer; MmResult err = MixerInterop.mixerGetControlDetails(mixerHandle, ref mixerControlDetails, MixerFlags.Value | mixerHandleType); // let the derived classes get the details before we free the handle if (err == MmResult.NoError) { GetDetails(mixerControlDetails.paDetails); } Marshal.FreeCoTaskMem(buffer); if (err != MmResult.NoError) { throw new MmException(err, "mixerGetControlDetails"); } } /// /// Gets the control details /// /// protected abstract void GetDetails(IntPtr pDetails); /// /// Mixer control name /// public String Name { get { return mixerControl.szName; } } /// /// Mixer control type /// public MixerControlType ControlType { get { return mixerControl.dwControlType; } } /// /// Returns true if this is a boolean control /// /// Control type private static bool IsControlBoolean(MixerControlType controlType) { switch (controlType) { case MixerControlType.BooleanMeter: case MixerControlType.Boolean: case MixerControlType.Button: case MixerControlType.Loudness: case MixerControlType.Mono: case MixerControlType.Mute: case MixerControlType.OnOff: case MixerControlType.StereoEnhance: case MixerControlType.Mixer: case MixerControlType.MultipleSelect: case MixerControlType.Mux: case MixerControlType.SingleSelect: return true; default: return false; } } /// /// Is this a boolean control /// public bool IsBoolean { get { return MixerControl.IsControlBoolean(mixerControl.dwControlType); } } /// /// Determines whether a specified mixer control type is a list text control /// private static bool IsControlListText(MixerControlType controlType) { switch (controlType) { case MixerControlType.Equalizer: case MixerControlType.Mixer: case MixerControlType.MultipleSelect: case MixerControlType.Mux: case MixerControlType.SingleSelect: return true; default: return false; } } /// /// True if this is a list text control /// public bool IsListText { get { return MixerControl.IsControlListText(mixerControl.dwControlType); } } private static bool IsControlSigned(MixerControlType controlType) { switch (controlType) { case MixerControlType.PeakMeter: case MixerControlType.SignedMeter: case MixerControlType.Signed: case MixerControlType.Decibels: case MixerControlType.Pan: case MixerControlType.QSoundPan: case MixerControlType.Slider: return true; default: return false; } } /// /// True if this is a signed control /// public bool IsSigned { get { return MixerControl.IsControlSigned(mixerControl.dwControlType); } } private static bool IsControlUnsigned(MixerControlType controlType) { switch (controlType) { case MixerControlType.UnsignedMeter: case MixerControlType.Unsigned: case MixerControlType.Bass: case MixerControlType.Equalizer: case MixerControlType.Fader: case MixerControlType.Treble: case MixerControlType.Volume: case MixerControlType.MicroTime: case MixerControlType.MilliTime: case MixerControlType.Percent: return true; default: return false; } } /// /// True if this is an unsigned control /// public bool IsUnsigned { get { return MixerControl.IsControlUnsigned(mixerControl.dwControlType); } } private static bool IsControlCustom(MixerControlType controlType) { return (controlType == MixerControlType.Custom); } /// /// True if this is a custom control /// public bool IsCustom { get { return MixerControl.IsControlCustom(mixerControl.dwControlType); } } /// /// String representation for debug purposes /// public override string ToString() { return String.Format("{0} {1}", Name, ControlType); } } }