Update README.md

Add sanity-check to CueSDK.EnableKeypressHandler()

CUE.NET.csproj

@@ -59,6 +59,7 @@
     <Compile Include="Devices\Generic\Enums\CorsairAccessMode.cs" />
     <Compile Include="Devices\Generic\Enums\CorsairDeviceCaps.cs" />
     <Compile Include="Devices\Generic\Enums\CorsairDeviceType.cs" />
+    <Compile Include="Devices\Generic\Enums\CorsairKeyId.cs" />
     <Compile Include="Devices\Generic\Enums\CorsairLedId.cs" />
     <Compile Include="Devices\Generic\EventArgs\ExceptionEventArgs.cs" />
     <Compile Include="Brushes\AbstractBrush.cs" />
@@ -67,7 +68,12 @@
     <Compile Include="Devices\Generic\EventArgs\UpdatedEventArgs.cs" />
     <Compile Include="Devices\Generic\EventArgs\UpdatingEventArgs.cs" />
     <Compile Include="Devices\Generic\LedUpateRequest.cs" />
+    <Compile Include="Devices\HeadsetStand\CorsairHeadsetStand.cs" />
+    <Compile Include="Devices\HeadsetStand\CorsairHeadsetStandDeviceInfo.cs" />
+    <Compile Include="Devices\HeadsetStand\Enums\CorsairHeadsetStandLedId.cs" />
     <Compile Include="Devices\Keyboard\Enums\BrushCalculationMode.cs" />
+    <Compile Include="Devices\Keyboard\Enums\CorsairKeyboardKeyId.cs" />
+    <Compile Include="Devices\Mouse\Enums\CorsairMouseKeyId.cs" />
     <Compile Include="Effects\AbstractLedGroupEffect.cs" />
     <Compile Include="Effects\AbstractBrushEffect.cs" />
     <Compile Include="Effects\AbstractEffectTarget.cs" />
@@ -76,6 +82,7 @@
     <Compile Include="Devices\Mousemat\CorsairMousematDeviceInfo.cs" />
     <Compile Include="Devices\Mousemat\Enums\CorsairMousematLedId.cs" />
     <Compile Include="Effects\MoveGradientEffect.cs" />
+    <Compile Include="EventArgs\KeyPressedEventArgs.cs" />
     <Compile Include="Gradients\AbstractGradient.cs" />
     <Compile Include="Gradients\GradientStop.cs" />
     <Compile Include="Gradients\IGradient.cs" />

CUE.NET.nuspec

@@ -3,14 +3,20 @@
   <metadata>
     <id>CUE.NET</id>
     <title>CUE.NET</title>
-    <version>1.1.3.0</version>
+    <version>1.2.0.1</version>
     <authors>Darth Affe</authors>
     <owners>Darth Affe</owners>
     <projectUrl>https://github.com/DarthAffe/CUE.NET</projectUrl>
     <licenseUrl>https://raw.githubusercontent.com/DarthAffe/CUE.NET/master/LICENSE</licenseUrl>
     <requireLicenseAcceptance>true</requireLicenseAcceptance>
     <description>Corsair HID SDK Wrapper</description>
-    <releaseNotes>Updated SDK to 2.10.91 (this adds lightbar support)</releaseNotes>
+    <releaseNotes>
+      - Updated SDK to 2.18.127
+      - Added methods to use the new GetColor method
+      - Added an event to get the key-change of special keys (G and M)
+      - Fixed missing LoadedArchitecture assignment
+      - Fixed an issue that prevents further reinitializing if an exception was thrown earlier
+    </releaseNotes>
     <summary>C# (.NET) Wrapper library around the Corsair CUE-SDK</summary>
     <copyright>Copyright © Wyrez 2017</copyright>
     <language>en-US</language>

CueSDK.cs

@@ -1,6 +1,7 @@
 // ReSharper disable MemberCanBePrivate.Global
 // ReSharper disable UnusedMember.Global
 
+using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
 using System.Runtime.InteropServices;
@@ -8,9 +9,11 @@ using CUE.NET.Devices;
 using CUE.NET.Devices.Generic;
 using CUE.NET.Devices.Generic.Enums;
 using CUE.NET.Devices.Headset;
+using CUE.NET.Devices.HeadsetStand;
 using CUE.NET.Devices.Keyboard;
 using CUE.NET.Devices.Mouse;
 using CUE.NET.Devices.Mousemat;
+using CUE.NET.EventArgs;
 using CUE.NET.Exceptions;
 using CUE.NET.Native;
 
@@ -25,6 +28,18 @@ namespace CUE.NET
 
         // ReSharper disable UnusedAutoPropertyAccessor.Global
 
+        /// <summary>
+        /// Gets a modifiable list of paths used to find the native SDK-dlls for x86 applications.
+        /// The first match will be used.
+        /// </summary>
+        public static List<string> PossibleX86NativePaths { get; } = new List<string> { "x86/CUESDK_2015.dll", "x86/CUESDK.dll" };
+
+        /// <summary>
+        /// Gets a modifiable list of paths used to find the native SDK-dlls for x64 applications.
+        /// The first match will be used.
+        /// </summary>
+        public static List<string> PossibleX64NativePaths { get; } = new List<string> { "x64/CUESDK_2015.dll", "x64/CUESDK.dll" };
+
         /// <summary>
         /// Indicates if the SDK is initialized and ready to use.
         /// </summary>
@@ -74,13 +89,35 @@ namespace CUE.NET
         public static CorsairHeadset HeadsetSDK { get; private set; }
 
         /// <summary>
-        /// Gets the managed representation of a moustmat managed by the CUE-SDK.
+        /// Gets the managed representation of a mousemat managed by the CUE-SDK.
         /// Note that currently only one connected mousemat is supported.
         /// </summary>
         public static CorsairMousemat MousematSDK { get; private set; }
 
+        /// <summary>
+        /// Gets the managed representation of a headset stand managed by the CUE-SDK.
+        /// Note that currently only one connected headset stand is supported.
+        /// </summary>
+        public static CorsairHeadsetStand HeadsetStandSDK { get; private set; }
+
         // ReSharper restore UnusedAutoPropertyAccessor.Global
 
+        [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
+        private delegate void OnKeyPressedDelegate(IntPtr context, CorsairKeyId keyId, [MarshalAs(UnmanagedType.I1)] bool pressed);
+        private static OnKeyPressedDelegate _onKeyPressedDelegate;
+
+        #endregion
+
+        #region Events
+
+        /// <summary>
+        /// Occurs when the SDK reports that a key is pressed.
+        /// Notice that right now only G- (keyboard) and M- (mouse) keys are supported.
+        /// 
+        /// To enable this event <see cref="EnableKeypressCallback"/> needs to be called.
+        /// </summary>
+        public static event EventHandler<KeyPressedEventArgs> KeyPressed;
+
         #endregion
 
         #region Methods
@@ -108,6 +145,8 @@ namespace CUE.NET
                             return HeadsetSDK != null;
                         case CorsairDeviceType.Mousemat:
                             return MousematSDK != null;
+                        case CorsairDeviceType.HeadsetStand:
+                            return HeadsetStandSDK != null;
                         default:
                             return true;
                     }
@@ -154,7 +193,7 @@ namespace CUE.NET
 
             CorsairError error = LastError;
             if (error != CorsairError.Success)
-                Throw(error);
+                Throw(error, true);
 
             if (ProtocolDetails.BreakingChanges)
                 throw new WrapperException("The SDK currently used isn't compatible with the installed version of CUE.\r\n"
@@ -164,7 +203,7 @@ namespace CUE.NET
             if (exclusiveAccess)
             {
                 if (!_CUESDK.CorsairRequestControl(CorsairAccessMode.ExclusiveLightingControl))
-                    Throw(LastError);
+                    Throw(LastError, true);
 
                 HasExclusiveAccess = true;
             }
@@ -193,6 +232,9 @@ namespace CUE.NET
                     case CorsairDeviceType.Mousemat:
                         device = MousematSDK = new CorsairMousemat(new CorsairMousematDeviceInfo(nativeDeviceInfo));
                         break;
+                    case CorsairDeviceType.HeadsetStand:
+                        device = HeadsetStandSDK = new CorsairHeadsetStand(new CorsairHeadsetStandDeviceInfo(nativeDeviceInfo));
+                        break;
                     // ReSharper disable once RedundantCaseLabel
                     case CorsairDeviceType.Unknown:
                     default:
@@ -204,14 +246,45 @@ namespace CUE.NET
 
                 error = LastError;
                 if (error != CorsairError.Success)
-                    Throw(error);
+                    Throw(error, true);
             }
 
+            error = LastError;
+            if (error != CorsairError.Success)
+                Throw(error, false);
+
             InitializedDevices = new ReadOnlyCollection<ICueDevice>(devices);
 
             IsInitialized = true;
         }
 
+        /// <summary>
+        /// Enables the keypress-callback.
+        /// This method needs to be called to enable the <see cref="KeyPressed"/>-event.
+        /// 
+        /// WARNING: AFTER THIS METHOD IS CALLED IT'S NO LONGER POSSIBLE TO REINITIALIZE THE SDK!
+        /// </summary>
+        public static void EnableKeypressCallback()
+        {
+            if (!IsInitialized)
+                throw new WrapperException("CueSDK isn't initialized.");
+
+            if (_onKeyPressedDelegate != null)
+                return;
+
+            _onKeyPressedDelegate = OnKeyPressed;
+            _CUESDK.CorsairRegisterKeypressCallback(Marshal.GetFunctionPointerForDelegate(_onKeyPressedDelegate), IntPtr.Zero);
+        }
+
+        /// <summary>
+        /// Resets the colors of all devices back to the last saved color-data. (If there wasn't a manual save, that's the data from the time the SDK was initialized.)
+        /// </summary>
+        public static void Reset()
+        {
+            foreach (ICueDevice device in InitializedDevices)
+                device.RestoreColors();
+        }
+
         /// <summary>
         /// Reinitialize the CUE-SDK and temporarily hand back full control to CUE.
         /// </summary>
@@ -229,10 +302,14 @@ namespace CUE.NET
             if (!IsInitialized)
                 throw new WrapperException("CueSDK isn't initialized.");
 
+            if (_onKeyPressedDelegate != null)
+                throw new WrapperException("Keypress-Callback is enabled.");
+
             KeyboardSDK?.ResetLeds();
             MouseSDK?.ResetLeds();
             HeadsetSDK?.ResetLeds();
             MousematSDK?.ResetLeds();
+            HeadsetStandSDK?.ResetLeds();
 
             _CUESDK.Reload();
 
@@ -240,7 +317,7 @@ namespace CUE.NET
 
             CorsairError error = LastError;
             if (error != CorsairError.Success)
-                Throw(error);
+                Throw(error, false);
 
             if (ProtocolDetails.BreakingChanges)
                 throw new WrapperException("The SDK currently used isn't compatible with the installed version of CUE.\r\n"
@@ -249,7 +326,7 @@ namespace CUE.NET
 
             if (exclusiveAccess)
                 if (!_CUESDK.CorsairRequestControl(CorsairAccessMode.ExclusiveLightingControl))
-                    Throw(LastError);
+                    Throw(LastError, false);
             HasExclusiveAccess = exclusiveAccess;
 
             int deviceCount = _CUESDK.CorsairGetDeviceCount();
@@ -264,7 +341,7 @@ namespace CUE.NET
 
                 error = LastError;
                 if (error != CorsairError.Success)
-                    Throw(error);
+                    Throw(error, false);
             }
 
             if (KeyboardSDK != null)
@@ -283,23 +360,38 @@ namespace CUE.NET
                 if (!reloadedDevices.ContainsKey(CorsairDeviceType.Mousemat)
                     || MousematSDK.MousematDeviceInfo.Model != reloadedDevices[CorsairDeviceType.Mousemat].Model)
                     throw new WrapperException("The previously loaded Mousemat got disconnected.");
+            if (HeadsetStandSDK != null)
+                if (!reloadedDevices.ContainsKey(CorsairDeviceType.HeadsetStand)
+                    || HeadsetStandSDK.HeadsetStandDeviceInfo.Model != reloadedDevices[CorsairDeviceType.HeadsetStand].Model)
+                    throw new WrapperException("The previously loaded Headset Stand got disconnected.");
+
+            error = LastError;
+            if (error != CorsairError.Success)
+                Throw(error, false);
 
             IsInitialized = true;
         }
 
-        private static void Throw(CorsairError error)
+        private static void Throw(CorsairError error, bool reset)
         {
-            ProtocolDetails = null;
+            if (reset)
-            HasExclusiveAccess = false;
+            {
-            KeyboardSDK = null;
+                ProtocolDetails = null;
-            MouseSDK = null;
+                HasExclusiveAccess = false;
-            HeadsetSDK = null;
+                KeyboardSDK = null;
-            MousematSDK = null;
+                MouseSDK = null;
-            IsInitialized = false;
+                HeadsetSDK = null;
+                MousematSDK = null;
+                HeadsetStandSDK = null;
+                IsInitialized = false;
+            }
 
             throw new CUEException(error);
         }
 
+        private static void OnKeyPressed(IntPtr context, CorsairKeyId keyId, bool pressed)
+            => KeyPressed?.Invoke(null, new KeyPressedEventArgs(keyId, pressed));
+
         #endregion
     }
 }

Devices/Generic/AbstractCueDevice.cs

@@ -29,6 +29,8 @@ namespace CUE.NET.Devices.Generic
 
         private static DateTime _lastUpdate = DateTime.Now;
 
+        private Dictionary<CorsairLedId, CorsairColor> _colorDataSave;
+
         /// <summary>
         /// Gets generic information provided by CUE for the device.
         /// </summary>
@@ -56,6 +58,7 @@ namespace CUE.NET.Devices.Generic
 
         /// <summary>
         /// Gets or sets the background brush of the keyboard.
+        /// If this is null the last saved color-data is used as background.
         /// </summary>
         public IBrush Brush { get; set; }
 
@@ -153,6 +156,7 @@ namespace CUE.NET.Devices.Generic
         public virtual void Initialize()
         {
             DeviceRectangle = RectangleHelper.CreateRectangleFromRectangles((this).Select(x => x.LedRectangle));
+            SaveColors();
         }
 
         /// <summary>
@@ -187,19 +191,26 @@ namespace CUE.NET.Devices.Generic
         /// Performs an update for all dirty keys, or all keys if flushLeds is set to true.
         /// </summary>
         /// <param name="flushLeds">Specifies whether all keys (including clean ones) should be updated.</param>
-        public void Update(bool flushLeds = false)
+        /// <param name="noRender">Only updates the hardware-leds skippin effects and the render-pass. Only use this if you know what that means!</param>
+        public void Update(bool flushLeds = false, bool noRender = false)
         {
             OnUpdating();
 
-            // Update effects
+            if (!noRender)
-            foreach (ILedGroup ledGroup in LedGroups)
+            {
-                ledGroup.UpdateEffects();
+                // Update effects
+                foreach (ILedGroup ledGroup in LedGroups)
+                    ledGroup.UpdateEffects();
 
-            // Render brushes
+                // Render brushes
-            Render(this);
+                if (Brush != null)
-            foreach (ILedGroup ledGroup in LedGroups.OrderBy(x => x.ZIndex))
+                    Render(this);
-                Render(ledGroup);
+                else
+                    ApplyColorData(_colorDataSave);
 
+                foreach (ILedGroup ledGroup in LedGroups.OrderBy(x => x.ZIndex))
+                    Render(ledGroup);
+            }
             // Device-specific updates
             DeviceUpdate();
 
@@ -293,6 +304,63 @@ namespace CUE.NET.Devices.Generic
             OnLedsUpdated(updateRequests);
         }
 
+        /// <inheritdoc />
+        public void SyncColors()
+        {
+            Dictionary<CorsairLedId, CorsairColor> colorData = GetColors();
+            ApplyColorData(colorData);
+            Update(true, true);
+        }
+
+        /// <inheritdoc />
+        public void SaveColors()
+        {
+            _colorDataSave = GetColors();
+        }
+
+        /// <inheritdoc />
+        public void RestoreColors()
+        {
+            ApplyColorData(_colorDataSave);
+            Update(true, true);
+        }
+
+        private void ApplyColorData(Dictionary<CorsairLedId, CorsairColor> colorData)
+        {
+            if (colorData == null) return;
+
+            foreach (KeyValuePair<CorsairLedId, CorsairColor> corsairColor in _colorDataSave)
+                LedMapping[corsairColor.Key].Color = corsairColor.Value;
+        }
+
+        private Dictionary<CorsairLedId, CorsairColor> GetColors()
+        {
+            int structSize = Marshal.SizeOf(typeof(_CorsairLedColor));
+            IntPtr ptr = Marshal.AllocHGlobal(structSize * LedMapping.Count);
+            IntPtr addPtr = new IntPtr(ptr.ToInt64());
+            foreach (KeyValuePair<CorsairLedId, CorsairLed> led in LedMapping)
+            {
+                _CorsairLedColor color = new _CorsairLedColor { ledId = (int)led.Value.Id };
+                Marshal.StructureToPtr(color, addPtr, false);
+                addPtr = new IntPtr(addPtr.ToInt64() + structSize);
+            }
+            _CUESDK.CorsairGetLedsColors(LedMapping.Count, ptr);
+
+            IntPtr readPtr = ptr;
+            Dictionary<CorsairLedId, CorsairColor> colorData = new Dictionary<CorsairLedId, CorsairColor>();
+            for (int i = 0; i < LedMapping.Count; i++)
+            {
+                _CorsairLedColor ledColor = (_CorsairLedColor)Marshal.PtrToStructure(readPtr, typeof(_CorsairLedColor));
+                colorData.Add((CorsairLedId)ledColor.ledId, new CorsairColor((byte)ledColor.r, (byte)ledColor.g, (byte)ledColor.b));
+
+                readPtr = new IntPtr(readPtr.ToInt64() + structSize);
+            }
+
+            Marshal.FreeHGlobal(ptr);
+
+            return colorData;
+        }
+
         #endregion
 
         #region LedGroup
@@ -345,6 +413,12 @@ namespace CUE.NET.Devices.Generic
 
         #region Effects
 
+        /// <summary>
+        /// Gets a list of all active effects of this target.
+        /// For this device this is always null.
+        /// </summary>
+        public IList<IEffect<ILedGroup>> Effects => null;
+
         /// <summary>
         /// NOT IMPLEMENTED: Effects can't be applied directly to the device. Add it to the Brush or create a ledgroup instead.
         /// </summary>

Devices/Generic/Enums/CorsairDeviceType.cs

@@ -15,6 +15,7 @@ namespace CUE.NET.Devices.Generic.Enums
         Mouse = 1,
         Keyboard = 2,
         Headset = 3,
-        Mousemat = 4
+        Mousemat = 4,
+        HeadsetStand = 5
     };
 }

Devices/Generic/Enums/CorsairKeyId.cs

@@ -0,0 +1,46 @@
+// ReSharper disable InconsistentNaming
+
+#pragma warning disable 1591 // Missing XML comment for publicly visible type or member
+
+namespace CUE.NET.Devices.Generic.Enums
+{
+    /// <summary>
+    /// Contains list of all KeyIds available for all corsair devices.
+    /// </summary>
+    public enum CorsairKeyId
+    {
+        Invalid = 0,
+
+        G1 = 1,
+        G2 = 2,
+        G3 = 3,
+        G4 = 4,
+        G5 = 5,
+        G6 = 6,
+        G7 = 7,
+        G8 = 8,
+        G9 = 9,
+        G10 = 10,
+        G11 = 11,
+        G12 = 12,
+        G13 = 13,
+        G14 = 14,
+        G15 = 15,
+        G16 = 16,
+        G17 = 17,
+        G18 = 18,
+
+        M1 = 19,
+        M2 = 20,
+        M3 = 21,
+        M4 = 22,
+        M5 = 23,
+        M6 = 24,
+        M7 = 25,
+        M8 = 26,
+        M9 = 27,
+        M10 = 28,
+        M11 = 29,
+        M12 = 30,
+    }
+}

Devices/Generic/Enums/CorsairLedId.cs

@@ -205,5 +205,15 @@ namespace CUE.NET.Devices.Generic.Enums
         Lightbar17 = 186,
         Lightbar18 = 187,
         Lightbar19 = 188,
+
+        HeadsetStandZone1 = 191,
+        HeadsetStandZone2 = 192,
+        HeadsetStandZone3 = 193,
+        HeadsetStandZone4 = 194,
+        HeadsetStandZone5 = 195,
+        HeadsetStandZone6 = 196,
+        HeadsetStandZone7 = 197,
+        HeadsetStandZone8 = 198,
+        HeadsetStandZone9 = 199,
     }
 }

Devices/HeadsetStand/CorsairHeadsetStand.cs

@@ -0,0 +1,91 @@
+// ReSharper disable UnusedAutoPropertyAccessor.Global
+// ReSharper disable MemberCanBePrivate.Global
+// ReSharper disable UnusedMember.Global
+
+using System;
+using System.Collections.Generic;
+using System.Drawing;
+using System.Linq;
+using System.Runtime.InteropServices;
+using CUE.NET.Devices.Generic;
+using CUE.NET.Devices.Generic.Enums;
+using CUE.NET.Exceptions;
+using CUE.NET.Native;
+
+namespace CUE.NET.Devices.HeadsetStand
+{
+    /// <summary>
+    /// Represents the SDK for a corsair headset stand.
+    /// </summary>
+    public class CorsairHeadsetStand : AbstractCueDevice
+    {
+        #region Properties & Fields
+
+        /// <summary>
+        /// Gets specific information provided by CUE for the headset stand.
+        /// </summary>
+        public CorsairHeadsetStandDeviceInfo HeadsetStandDeviceInfo { get; }
+
+        #endregion
+
+        #region Constructors
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="CorsairHeadsetStand"/> class.
+        /// </summary>
+        /// <param name="info">The specific information provided by CUE for the headset stand</param>
+        internal CorsairHeadsetStand(CorsairHeadsetStandDeviceInfo info)
+            : base(info)
+        {
+            this.HeadsetStandDeviceInfo = info;
+        }
+
+        #endregion
+
+        #region Methods
+
+        /// <summary>
+        /// Initializes the headset stand.
+        /// </summary>
+        public override void Initialize()
+        {
+            int deviceCount = _CUESDK.CorsairGetDeviceCount();
+
+            // Get headset stand device index
+            int headsetStandIndex = -1;
+            for (int i = 0; i < deviceCount; i++)
+            {
+                _CorsairDeviceInfo nativeDeviceInfo = (_CorsairDeviceInfo)Marshal.PtrToStructure(_CUESDK.CorsairGetDeviceInfo(i), typeof(_CorsairDeviceInfo));
+                GenericDeviceInfo info = new GenericDeviceInfo(nativeDeviceInfo);
+                if (info.Type != CorsairDeviceType.HeadsetStand)
+                    continue;
+
+                headsetStandIndex = i;
+                break;
+            }
+            if (headsetStandIndex < 0)
+                throw new WrapperException("Can't determine headset stand device index");
+
+            _CorsairLedPositions nativeLedPositions = (_CorsairLedPositions)Marshal.PtrToStructure(_CUESDK.CorsairGetLedPositionsByDeviceIndex(headsetStandIndex), typeof(_CorsairLedPositions));
+            int structSize = Marshal.SizeOf(typeof(_CorsairLedPosition));
+            IntPtr ptr = nativeLedPositions.pLedPosition;
+
+            // Put the positions in an array for sorting later on
+            List<_CorsairLedPosition> positions = new List<_CorsairLedPosition>();
+            for (int i = 0; i < nativeLedPositions.numberOfLed; i++)
+            {
+                _CorsairLedPosition ledPosition = (_CorsairLedPosition)Marshal.PtrToStructure(ptr, typeof(_CorsairLedPosition));
+                ptr = new IntPtr(ptr.ToInt64() + structSize);
+                positions.Add(ledPosition);
+            }
+
+            // Sort for easy iteration by clients
+            foreach (_CorsairLedPosition ledPosition in positions.OrderBy(p => p.ledId))
+                InitializeLed(ledPosition.ledId, new RectangleF((float)ledPosition.left, (float)ledPosition.top, (float)ledPosition.width, (float)ledPosition.height));
+
+            base.Initialize();
+        }
+
+        #endregion
+    }
+}

Devices/HeadsetStand/CorsairHeadsetStandDeviceInfo.cs

@@ -0,0 +1,26 @@
+// ReSharper disable MemberCanBePrivate.Global
+// ReSharper disable UnusedAutoPropertyAccessor.Global
+
+using CUE.NET.Devices.Generic;
+using CUE.NET.Native;
+
+namespace CUE.NET.Devices.HeadsetStand
+{
+    /// <summary>
+    /// Represents specific information for a CUE headset stand.
+    /// </summary>
+    public class CorsairHeadsetStandDeviceInfo : GenericDeviceInfo
+    {
+        #region Constructors
+
+        /// <summary>
+        /// Internal constructor of managed <see cref="CorsairHeadsetStandDeviceInfo" />.
+        /// </summary>
+        /// <param name="nativeInfo">The native <see cref="_CorsairDeviceInfo" />-struct</param>
+        internal CorsairHeadsetStandDeviceInfo(_CorsairDeviceInfo nativeInfo)
+            : base(nativeInfo)
+        { }
+
+        #endregion
+    }
+}

Devices/HeadsetStand/Enums/CorsairHeadsetStandLedId.cs

@@ -0,0 +1,26 @@
+// ReSharper disable UnusedMember.Global
+// ReSharper disable InconsistentNaming
+
+#pragma warning disable 1591 // Missing XML comment for publicly visible type or member
+
+using CUE.NET.Devices.Generic.Enums;
+
+namespace CUE.NET.Devices.HeadsetStand.Enums
+{
+    /// <summary>
+    /// Contains list of all LEDs available for corsair headset stands.
+    /// </summary>
+    public static class CorsairHeadsetStandLedId
+    {
+        public const CorsairLedId Invalid = CorsairLedId.Invalid;
+        public const CorsairLedId HeadsetStandZone1 = CorsairLedId.HeadsetStandZone1;
+        public const CorsairLedId HeadsetStandZone2 = CorsairLedId.HeadsetStandZone2;
+        public const CorsairLedId HeadsetStandZone3 = CorsairLedId.HeadsetStandZone3;
+        public const CorsairLedId HeadsetStandZone4 = CorsairLedId.HeadsetStandZone4;
+        public const CorsairLedId HeadsetStandZone5 = CorsairLedId.HeadsetStandZone5;
+        public const CorsairLedId HeadsetStandZone6 = CorsairLedId.HeadsetStandZone6;
+        public const CorsairLedId HeadsetStandZone7 = CorsairLedId.HeadsetStandZone7;
+        public const CorsairLedId HeadsetStandZone8 = CorsairLedId.HeadsetStandZone8;
+        public const CorsairLedId HeadsetStandZone9 = CorsairLedId.HeadsetStandZone9;
+    }
+}

Devices/ICueDevice.cs

@@ -140,10 +140,26 @@ namespace CUE.NET.Devices
         void Initialize();
 
         /// <summary>
-        /// Perform an update for all dirty keys, or all keys if flushLeds is set to true.
+        /// Performs an update for all dirty keys, or all keys if flushLeds is set to true.
         /// </summary>
         /// <param name="flushLeds">Specifies whether all keys (including clean ones) should be updated.</param>
-        void Update(bool flushLeds = false);
+        /// <param name="noRender">Only updates the hardware-leds skippin effects and the render-pass. Only use this if you know what that means!</param>
+        void Update(bool flushLeds = false, bool noRender = false);
+
+        /// <summary>
+        /// Reads the currently active colors from the device and sync them with the internal state.
+        /// </summary>
+        void SyncColors();
+
+        /// <summary>
+        /// Saves the currently active colors from the device.
+        /// </summary>
+        void SaveColors();
+
+        /// <summary>
+        /// Restores the last saved colors.
+        /// </summary>
+        void RestoreColors();
 
         /// <summary>
         /// Attaches the given ledgroup.

Devices/Keyboard/Enums/CorsairKeyboardKeyId.cs

@@ -0,0 +1,36 @@
+// ReSharper disable UnusedMember.Global
+// ReSharper disable InconsistentNaming
+
+#pragma warning disable 1591 // Missing XML comment for publicly visible type or member
+
+using CUE.NET.Devices.Generic.Enums;
+
+namespace CUE.NET.Devices.Keyboard.Enums
+{
+    /// <summary>
+    /// Contains list of all LEDs available for corsair keyboards.
+    /// </summary>
+    public static class CorsairKeyboardKeyId
+    {
+        public const CorsairKeyId Invalid = CorsairKeyId.Invalid;
+
+        public const CorsairKeyId G1 = CorsairKeyId.G1;
+        public const CorsairKeyId G2 = CorsairKeyId.G2;
+        public const CorsairKeyId G3 = CorsairKeyId.G3;
+        public const CorsairKeyId G4 = CorsairKeyId.G4;
+        public const CorsairKeyId G5 = CorsairKeyId.G5;
+        public const CorsairKeyId G6 = CorsairKeyId.G6;
+        public const CorsairKeyId G7 = CorsairKeyId.G7;
+        public const CorsairKeyId G8 = CorsairKeyId.G8;
+        public const CorsairKeyId G9 = CorsairKeyId.G9;
+        public const CorsairKeyId G10 = CorsairKeyId.G10;
+        public const CorsairKeyId G11 = CorsairKeyId.G11;
+        public const CorsairKeyId G12 = CorsairKeyId.G12;
+        public const CorsairKeyId G13 = CorsairKeyId.G13;
+        public const CorsairKeyId G14 = CorsairKeyId.G14;
+        public const CorsairKeyId G15 = CorsairKeyId.G15;
+        public const CorsairKeyId G16 = CorsairKeyId.G16;
+        public const CorsairKeyId G17 = CorsairKeyId.G17;
+        public const CorsairKeyId G18 = CorsairKeyId.G18;
+    }
+}

Devices/Mouse/CorsairMouse.cs

@@ -2,10 +2,16 @@
 // ReSharper disable UnusedAutoPropertyAccessor.Global
 // ReSharper disable UnusedMember.Global
 
+using System;
+using System.Collections.Generic;
 using System.Drawing;
+using System.Linq;
+using System.Runtime.InteropServices;
 using CUE.NET.Devices.Generic;
+using CUE.NET.Devices.Generic.Enums;
 using CUE.NET.Devices.Mouse.Enums;
 using CUE.NET.Exceptions;
+using CUE.NET.Native;
 
 namespace CUE.NET.Devices.Mouse
 {
@@ -44,6 +50,14 @@ namespace CUE.NET.Devices.Mouse
         /// </summary>
         public override void Initialize()
         {
+            // Glaive is a special flake that doesn't follow the default layout
+            if (MouseDeviceInfo.Model == "GLAIVE RGB")
+            {
+                InitializeLed(CorsairMouseLedId.B1, new RectangleF(0, 0, 1, 1)); // Logo
+                InitializeLed(CorsairMouseLedId.B2, new RectangleF(2, 0, 1, 1)); // Front
+                InitializeLed(CorsairMouseLedId.B5, new RectangleF(3, 0, 1, 1)); // Sides
+                return;
+            }
             switch (MouseDeviceInfo.PhysicalLayout)
             {
                 case CorsairPhysicalMouseLayout.Zones1:

Devices/Mouse/Enums/CorsairMouseKeyId.cs

@@ -0,0 +1,30 @@
+// ReSharper disable UnusedMember.Global
+// ReSharper disable InconsistentNaming
+
+#pragma warning disable 1591 // Missing XML comment for publicly visible type or member
+
+using CUE.NET.Devices.Generic.Enums;
+
+namespace CUE.NET.Devices.Mouse.Enums
+{
+    /// <summary>
+    /// Contains list of all LEDs available for corsair mice.
+    /// </summary>
+    public static class CorsairMouseKeyId
+    {
+        public const CorsairKeyId Invalid = CorsairKeyId.Invalid;
+
+        public const CorsairKeyId M1 = CorsairKeyId.M1;
+        public const CorsairKeyId M2 = CorsairKeyId.M2;
+        public const CorsairKeyId M3 = CorsairKeyId.M3;
+        public const CorsairKeyId M4 = CorsairKeyId.M4;
+        public const CorsairKeyId M5 = CorsairKeyId.M5;
+        public const CorsairKeyId M6 = CorsairKeyId.M6;
+        public const CorsairKeyId M7 = CorsairKeyId.M7;
+        public const CorsairKeyId M8 = CorsairKeyId.M8;
+        public const CorsairKeyId M9 = CorsairKeyId.M9;
+        public const CorsairKeyId M10 = CorsairKeyId.M10;
+        public const CorsairKeyId M11 = CorsairKeyId.M11;
+        public const CorsairKeyId M12 = CorsairKeyId.M12;
+    }
+}

Effects/AbstractEffectTarget.cs

@@ -24,7 +24,7 @@ namespace CUE.NET.Effects
         /// <summary>
         /// Gets all <see cref="IEffect{T}" /> attached to this target.
         /// </summary>
-        protected IList<IEffect<T>> Effects => EffectTimes.Select(x => x.Effect).Cast<IEffect<T>>().ToList();
+        public IList<IEffect<T>> Effects => EffectTimes.Select(x => x.Effect).Cast<IEffect<T>>().ToList();
 
         /// <summary>
         /// Gets the strongly-typed target used for the effect.

Effects/IEffectTarget.cs

@@ -1,14 +1,25 @@
 // ReSharper disable UnusedMember.Global
 
+using System.Collections.Generic;
+
 namespace CUE.NET.Effects
 {
     /// <summary>
     /// Represents a basic effect-target.
     /// </summary>
     /// <typeparam name="T">The type this target represents.</typeparam>
-    public interface IEffectTarget<out T>
+    public interface IEffectTarget<T>
         where T : IEffectTarget<T>
     {
+        #region Properties & Fields
+
+        /// <summary>
+        /// Gets a list of all active effects of this target.
+        /// </summary>
+        IList<IEffect<T>> Effects { get; }
+
+        #endregion
+
         #region Methods
 
         /// <summary>

EventArgs/KeyPressedEventArgs.cs

@@ -0,0 +1,41 @@
+// ReSharper disable MemberCanBePrivate.Global
+
+using CUE.NET.Devices.Generic.Enums;
+
+namespace CUE.NET.EventArgs
+{
+    /// <summary>
+    ///  Represents the data provided by the <see cref="CueSDK.KeyPressed"/>-event.
+    /// </summary>
+    public class KeyPressedEventArgs : System.EventArgs
+    {
+        #region Properties & Fields
+
+        /// <summary>
+        /// Gets the id of the key.
+        /// </summary>
+        public CorsairKeyId KeyId { get; }
+
+        /// <summary>
+        /// Gets the current status of the key (true = pressed, flase = released).
+        /// </summary>
+        public bool IsPressed { get; }
+
+        #endregion
+
+        #region Constructors
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="KeyPressedEventArgs"/> class.
+        /// </summary>
+        /// <param name="keyId">The id of the key.</param>
+        /// <param name="isPressed">The current status of the key (true = pressed, flase = released).</param>
+        public KeyPressedEventArgs(CorsairKeyId keyId, bool isPressed)
+        {
+            this.KeyId = keyId;
+            this.IsPressed = isPressed;
+        }
+
+        #endregion
+    }
+}

Examples/Ambilight/Example_Ambilight_full/Ambilight.cs

@@ -1,5 +1,4 @@
-using System;
+using System.Drawing;
-using System.Drawing;
 using CUE.NET;
 using CUE.NET.Brushes;
 using CUE.NET.Devices.Generic.Enums;
@@ -36,7 +35,7 @@ namespace Example_Ambilight_full
             {
                 CueSDK.Initialize();
                 CueSDK.UpdateMode = UpdateMode.Continuous;
-                CueSDK.UpdateFrequency = 1 / 20f;
+                CueSDK.UpdateFrequency = 1f / _settings.UpdateRate;
 
                 SetAmbilightBrush();
                 _settings.AmbienceCreatorTypeChanged += (sender, args) => SetAmbilightBrush();

Examples/Ambilight/Example_Ambilight_full/Example_Ambilight_full.csproj

@@ -41,8 +41,8 @@
     <ApplicationIcon>Resources\ambilight.ico</ApplicationIcon>
   </PropertyGroup>
   <ItemGroup>
-    <Reference Include="CUE.NET, Version=1.1.1.0, Culture=neutral, processorArchitecture=MSIL">
+    <Reference Include="CUE.NET, Version=1.1.3.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\..\..\packages\CUE.NET.1.1.1\lib\net45\CUE.NET.dll</HintPath>
+      <HintPath>..\..\..\packages\CUE.NET.1.1.3.0\lib\net45\CUE.NET.dll</HintPath>
       <Private>True</Private>
     </Reference>
     <Reference Include="Hardcodet.Wpf.TaskbarNotification, Version=1.0.5.0, Culture=neutral, processorArchitecture=MSIL">
@@ -152,12 +152,12 @@
     <Resource Include="Resources\ambilight.ico" />
   </ItemGroup>
   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
-  <Import Project="..\..\..\packages\CUE.NET.1.1.1\build\net45\CUE.NET.targets" Condition="Exists('..\..\..\packages\CUE.NET.1.1.1\build\net45\CUE.NET.targets')" />
+  <Import Project="..\..\..\packages\CUE.NET.1.1.3.0\build\net45\CUE.NET.targets" Condition="Exists('..\..\..\packages\CUE.NET.1.1.3.0\build\net45\CUE.NET.targets')" />
   <Target Name="EnsureNuGetPackageBuildImports" BeforeTargets="PrepareForBuild">
     <PropertyGroup>
       <ErrorText>This project references NuGet package(s) that are missing on this computer. Use NuGet Package Restore to download them.  For more information, see http://go.microsoft.com/fwlink/?LinkID=322105. The missing file is {0}.</ErrorText>
     </PropertyGroup>
-    <Error Condition="!Exists('..\..\..\packages\CUE.NET.1.1.1\build\net45\CUE.NET.targets')" Text="$([System.String]::Format('$(ErrorText)', '..\..\..\packages\CUE.NET.1.1.1\build\net45\CUE.NET.targets'))" />
+    <Error Condition="!Exists('..\..\..\packages\CUE.NET.1.1.3.0\build\net45\CUE.NET.targets')" Text="$([System.String]::Format('$(ErrorText)', '..\..\..\packages\CUE.NET.1.1.3.0\build\net45\CUE.NET.targets'))" />
   </Target>
   <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
        Other similar extension points exist, see Microsoft.Common.targets.

Examples/Ambilight/Example_Ambilight_full/Properties/AssemblyInfo.cs

@@ -49,5 +49,5 @@ using System.Windows;
 // You can specify all the values or you can default the Build and Revision Numbers 
 // by using the '*' as shown below:
 // [assembly: AssemblyVersion("1.0.*")]
-[assembly: AssemblyVersion("1.0.1.1")]
+[assembly: AssemblyVersion("1.0.1.3")]
-[assembly: AssemblyFileVersion("1.0.1.1")]
+[assembly: AssemblyFileVersion("1.0.1.3")]

Examples/Ambilight/Example_Ambilight_full/TakeAsIs/AmbilightSettings.cs

@@ -23,6 +23,7 @@ namespace Example_Ambilight_full.TakeAsIs
             }
         }
 
+        public int UpdateRate { get; set; } = 20;
         public int OffsetLeft { get; set; } = 0;
         public int OffsetRight { get; set; } = 0;
         public int OffsetTop { get; set; } = 0;

Examples/Ambilight/Example_Ambilight_full/TakeAsIs/ScreenCapturing/DX9ScreenCapture.cs

@@ -1,6 +1,7 @@
 using System;
 using System.Runtime.InteropServices;
 using System.Windows.Media;
+using Microsoft.Win32;
 using SharpDX;
 using SharpDX.Direct3D9;
 
@@ -27,6 +28,14 @@ namespace Example_Ambilight_full.TakeAsIs.ScreenCapturing
             Width = (int)System.Windows.SystemParameters.PrimaryScreenWidth;
             Height = (int)System.Windows.SystemParameters.PrimaryScreenHeight;
 
+            //DarthAffe 08.04.2017: Fix for system using windows-scaling. The primary screen size is reported 'wrong'.
+            double scaling = GetScaling();
+            if (Math.Abs(scaling - 1.0) > 0.01)
+            {
+                Width = (int)(Width / scaling);
+                Height = (int)(Height / scaling);
+            }
+
             PresentParameters presentParams = new PresentParameters(Width, Height)
             {
                 Windowed = true,
@@ -42,6 +51,19 @@ namespace Example_Ambilight_full.TakeAsIs.ScreenCapturing
 
         #region Methods
 
+        private double GetScaling()
+        {
+            try
+            {
+                int currentDpi = (int)Registry.GetValue("HKEY_CURRENT_USER\\Control Panel\\Desktop", "LogPixels", 96);
+                return 96.0 / currentDpi;
+            }
+            catch
+            {
+                return 1.0;
+            }
+        }
+
         public byte[] CaptureScreen()
         {
             _device.GetFrontBufferData(0, _surface);

Examples/Ambilight/Example_Ambilight_full/TakeAsIs/UI/ConfigViewModel.cs

@@ -12,8 +12,12 @@ namespace Example_Ambilight_full.TakeAsIs.UI
 
         public int UpdateRate
         {
-            get { return (int)Math.Round(1f / CueSDK.UpdateFrequency); }
+            get => (int)Math.Round(1f / CueSDK.UpdateFrequency);
-            set { CueSDK.UpdateFrequency = 1f / value; }
+            set
+            {
+                Settings.UpdateRate = value;
+                CueSDK.UpdateFrequency = 1f / value;
+            }
         }
 
         #endregion

Examples/Ambilight/Example_Ambilight_full/packages.config

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <packages>
-  <package id="CUE.NET" version="1.1.1" targetFramework="net45" />
+  <package id="CUE.NET" version="1.1.3.0" targetFramework="net45" />
   <package id="Hardcodet.NotifyIcon.Wpf" version="1.0.8" targetFramework="net45" />
   <package id="MahApps.Metro" version="1.4.0-ALPHA026" targetFramework="net45" />
   <package id="SharpDX" version="3.1.1" targetFramework="net45" />

Examples/SimpleDevTest/Program.cs

@@ -7,6 +7,7 @@ using System.Threading.Tasks;
 using CUE.NET;
 using CUE.NET.Brushes;
 using CUE.NET.Devices;
+using CUE.NET.Devices.Generic;
 using CUE.NET.Devices.Generic.Enums;
 using CUE.NET.Effects;
 using CUE.NET.Exceptions;
@@ -32,23 +33,62 @@ namespace SimpleDevTest
 
             try
             {
+                bool test = CueSDK.IsSDKAvailable();
+
                 // Initialize CUE-SDK
                 CueSDK.Initialize();
                 Console.WriteLine("Initialized with " + CueSDK.LoadedArchitecture + "-SDK");
 
-                float halfKeyboardWidth = CueSDK.KeyboardSDK.DeviceRectangle.Width / 2f;
+                CueSDK.EnableKeypressCallback();
-                ILedGroup left = new RectangleLedGroup(CueSDK.KeyboardSDK, new RectangleF(0, 0, halfKeyboardWidth, CueSDK.KeyboardSDK.DeviceRectangle.Height));
+
-                ILedGroup right = new RectangleLedGroup(CueSDK.KeyboardSDK, new RectangleF(halfKeyboardWidth, 0, halfKeyboardWidth, CueSDK.KeyboardSDK.DeviceRectangle.Height));
+                CueSDK.KeyPressed += (sender, eventArgs) => Console.WriteLine($"Key {eventArgs.KeyId} {(eventArgs.IsPressed ? "pressed" : "released")}");
+
+                //CueSDK.KeyboardSDK.Brush = (SolidColorBrush)Color.Black;
+                //CueSDK.KeyboardSDK[CorsairLedId.Z].Color = Color.Red;
+                //CueSDK.KeyboardSDK[CorsairLedId.Z].IsLocked = true;
+
+                float thirdKeyboardWidth = CueSDK.KeyboardSDK.DeviceRectangle.Width / 3f;
+                ILedGroup left = new RectangleLedGroup(CueSDK.KeyboardSDK, new RectangleF(CueSDK.KeyboardSDK.DeviceRectangle.X, CueSDK.KeyboardSDK.DeviceRectangle.Y, thirdKeyboardWidth, CueSDK.KeyboardSDK.DeviceRectangle.Height));
+                ILedGroup mid = new RectangleLedGroup(CueSDK.KeyboardSDK, new RectangleF(CueSDK.KeyboardSDK.DeviceRectangle.X + thirdKeyboardWidth, CueSDK.KeyboardSDK.DeviceRectangle.Y, thirdKeyboardWidth, CueSDK.KeyboardSDK.DeviceRectangle.Height));
+                ILedGroup right = new RectangleLedGroup(CueSDK.KeyboardSDK, new RectangleF(CueSDK.KeyboardSDK.DeviceRectangle.X + thirdKeyboardWidth * 2, CueSDK.KeyboardSDK.DeviceRectangle.Y, thirdKeyboardWidth, CueSDK.KeyboardSDK.DeviceRectangle.Height));
 
                 //CueSDK.KeyboardSDK.Brush = new LinearGradientBrush(new LinearGradient(true, new GradientStop(0, Color.Blue), new GradientStop(0.5f, Color.Red)));
-                left.Brush = new ConicalGradientBrush(new PointF(0.6f, 0.6f), new RainbowGradient(360, 0));
+                left.Brush = new ConicalGradientBrush(new PointF(0.6f, 0.7f), new RainbowGradient(360, 0));
                 left.Brush.AddEffect(new MoveGradientEffect());
+                left.Brush.AddEffect(new FlashEffect { Attack = 2, Sustain = 1f, Release = 2, Interval = 1f });
 
-                right.Brush = new ConicalGradientBrush(new PointF(0.4f, 0.6f), new RainbowGradient());
+                mid.Brush = new ConicalGradientBrush(new PointF(0.5f, 0.3f), new RainbowGradient());
+                mid.Brush.AddEffect(new MoveGradientEffect());
+                mid.Brush.AddEffect(new FlashEffect { Attack = 2, Sustain = 1f, Release = 2, Interval = 1f });
+
+                right.Brush = new ConicalGradientBrush(new PointF(0.4f, 0.7f), new RainbowGradient(360, 0));
                 right.Brush.AddEffect(new MoveGradientEffect());
+                right.Brush.AddEffect(new FlashEffect { Attack = 2, Sustain = 1f, Release = 2, Interval = 1f });
+
+                //float halfKeyboardWidth = CueSDK.KeyboardSDK.DeviceRectangle.Width / 2f;
+                //ILedGroup left = new RectangleLedGroup(CueSDK.KeyboardSDK, new RectangleF(CueSDK.KeyboardSDK.DeviceRectangle.X, CueSDK.KeyboardSDK.DeviceRectangle.Y, halfKeyboardWidth, CueSDK.KeyboardSDK.DeviceRectangle.Height));
+                //ILedGroup right = new RectangleLedGroup(CueSDK.KeyboardSDK, new RectangleF(CueSDK.KeyboardSDK.DeviceRectangle.X + halfKeyboardWidth, CueSDK.KeyboardSDK.DeviceRectangle.Y, halfKeyboardWidth, CueSDK.KeyboardSDK.DeviceRectangle.Height));
+
+                ////CueSDK.KeyboardSDK.Brush = new LinearGradientBrush(new LinearGradient(true, new GradientStop(0, Color.Blue), new GradientStop(0.5f, Color.Red)));
+                //left.Brush = new ConicalGradientBrush(new PointF(0.6f, 0.6f), new RainbowGradient(360, 0));
+                //left.Brush.AddEffect(new MoveGradientEffect());
+
+                //right.Brush = new ConicalGradientBrush(new PointF(0.4f, 0.6f), new RainbowGradient());
+                //right.Brush.AddEffect(new MoveGradientEffect());
 
                 CueSDK.UpdateMode = UpdateMode.Continuous;
 
+                Wait(5);
+                CueSDK.UpdateMode = UpdateMode.Manual;
+                for (int i = 0; i < 100000; i++)
+                {
+                    CueSDK.Reinitialize();
+                    Console.WriteLine(i);
+                }
+
+                Console.WriteLine("done!");
+                Wait(5);
+
                 //IBrush rainbowBrush = new LinearGradientBrush(new RainbowGradient());
                 //rainbowBrush.AddEffect(new FlashEffect { Attack = 5f, Sustain = 1f, Decay = 0, Release = 5f, Interval = 1f });
                 //rainbowBrush.AddEffect(new MoveRainbowEffect());

Examples/SimpleDevTest/Properties/AssemblyInfo.cs

@@ -31,5 +31,5 @@ using System.Runtime.InteropServices;
 // You can specify all the values or you can default the Build and Revision Numbers 
 // by using the '*' as shown below:
 // [assembly: AssemblyVersion("1.0.*")]
-[assembly: AssemblyVersion("1.1.3.0")]
+[assembly: AssemblyVersion("1.2.0.1")]
-[assembly: AssemblyFileVersion("1.1.3.0")]
+[assembly: AssemblyFileVersion("1.2.0.1")]

Native/_CUESDK.cs

@@ -2,7 +2,9 @@
 // ReSharper disable UnusedMember.Global
 
 using System;
+using System.Collections.Generic;
 using System.IO;
+using System.Linq;
 using System.Runtime.InteropServices;
 using CUE.NET.Devices.Generic.Enums;
 using CUE.NET.Exceptions;
@@ -20,7 +22,7 @@ namespace CUE.NET.Native
         /// Gets the loaded architecture (x64/x86).
         /// </summary>
         internal static string LoadedArchitecture { get; private set; }
-        
+
         /// <summary>
         /// Reloads the SDK.
         /// </summary>
@@ -34,13 +36,24 @@ namespace CUE.NET.Native
         {
             if (_dllHandle != IntPtr.Zero) return;
 
+            LoadedArchitecture = LoadedArchitecture = Environment.Is64BitProcess ? "x64" : "x86";
+
             // HACK: Load library at runtime to support both, x86 and x64 with one managed dll
-            string dllPath = (LoadedArchitecture = Environment.Is64BitProcess ? "x64" : "x86") + "/CUESDK_2015.dll";
+            List<string> possiblePathList = Environment.Is64BitProcess ? CueSDK.PossibleX64NativePaths : CueSDK.PossibleX86NativePaths;
-            if (!File.Exists(dllPath)) throw new WrapperException($"Can't find the CUE-SDK at the expected location '{Path.GetFullPath(dllPath)}'");
+            string dllPath = null;
+            foreach (string path in possiblePathList)
+                if (File.Exists(path))
+                {
+                    dllPath = path;
+                    break;
+                }
+
+            if (dllPath == null) throw new WrapperException($"Can't find the CUE-SDK at one of the expected locations:\r\n '{string.Join("\r\n", possiblePathList.Select(Path.GetFullPath))}'");
 
             _dllHandle = LoadLibrary(dllPath);
 
             _corsairSetLedsColorsPointer = (CorsairSetLedsColorsPointer)Marshal.GetDelegateForFunctionPointer(GetProcAddress(_dllHandle, "CorsairSetLedsColors"), typeof(CorsairSetLedsColorsPointer));
+            _corsairGetLedsColorsPointer = (CorsairGetLedsColorsPointer)Marshal.GetDelegateForFunctionPointer(GetProcAddress(_dllHandle, "CorsairGetLedsColors"), typeof(CorsairGetLedsColorsPointer));
             _corsairGetDeviceCountPointer = (CorsairGetDeviceCountPointer)Marshal.GetDelegateForFunctionPointer(GetProcAddress(_dllHandle, "CorsairGetDeviceCount"), typeof(CorsairGetDeviceCountPointer));
             _corsairGetDeviceInfoPointer = (CorsairGetDeviceInfoPointer)Marshal.GetDelegateForFunctionPointer(GetProcAddress(_dllHandle, "CorsairGetDeviceInfo"), typeof(CorsairGetDeviceInfoPointer));
             _corsairGetLedPositionsPointer = (CorsairGetLedPositionsPointer)Marshal.GetDelegateForFunctionPointer(GetProcAddress(_dllHandle, "CorsairGetLedPositions"), typeof(CorsairGetLedPositionsPointer));
@@ -50,6 +63,7 @@ namespace CUE.NET.Native
             _corsairReleaseControlPointer = (CorsairReleaseControlPointer)Marshal.GetDelegateForFunctionPointer(GetProcAddress(_dllHandle, "CorsairReleaseControl"), typeof(CorsairReleaseControlPointer));
             _corsairPerformProtocolHandshakePointer = (CorsairPerformProtocolHandshakePointer)Marshal.GetDelegateForFunctionPointer(GetProcAddress(_dllHandle, "CorsairPerformProtocolHandshake"), typeof(CorsairPerformProtocolHandshakePointer));
             _corsairGetLastErrorPointer = (CorsairGetLastErrorPointer)Marshal.GetDelegateForFunctionPointer(GetProcAddress(_dllHandle, "CorsairGetLastError"), typeof(CorsairGetLastErrorPointer));
+            _corsairRegisterKeypressCallbackPointer = (CorsairRegisterKeypressCallbackPointer)Marshal.GetDelegateForFunctionPointer(GetProcAddress(_dllHandle, "CorsairRegisterKeypressCallback"), typeof(CorsairRegisterKeypressCallbackPointer));
         }
 
         private static void UnloadCUESDK()
@@ -77,6 +91,7 @@ namespace CUE.NET.Native
         #region Pointers
 
         private static CorsairSetLedsColorsPointer _corsairSetLedsColorsPointer;
+        private static CorsairGetLedsColorsPointer _corsairGetLedsColorsPointer;
         private static CorsairGetDeviceCountPointer _corsairGetDeviceCountPointer;
         private static CorsairGetDeviceInfoPointer _corsairGetDeviceInfoPointer;
         private static CorsairGetLedPositionsPointer _corsairGetLedPositionsPointer;
@@ -86,6 +101,7 @@ namespace CUE.NET.Native
         private static CorsairReleaseControlPointer _corsairReleaseControlPointer;
         private static CorsairPerformProtocolHandshakePointer _corsairPerformProtocolHandshakePointer;
         private static CorsairGetLastErrorPointer _corsairGetLastErrorPointer;
+        private static CorsairRegisterKeypressCallbackPointer _corsairRegisterKeypressCallbackPointer;
 
         #endregion
 
@@ -94,6 +110,9 @@ namespace CUE.NET.Native
         [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
         private delegate bool CorsairSetLedsColorsPointer(int size, IntPtr ledsColors);
 
+        [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
+        private delegate bool CorsairGetLedsColorsPointer(int size, IntPtr ledsColors);
+
         [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
         private delegate int CorsairGetDeviceCountPointer();
 
@@ -121,6 +140,9 @@ namespace CUE.NET.Native
         [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
         private delegate CorsairError CorsairGetLastErrorPointer();
 
+        [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
+        private delegate bool CorsairRegisterKeypressCallbackPointer(IntPtr callback, IntPtr context);
+
         #endregion
 
         // ReSharper disable EventExceptionNotDocumented
@@ -133,6 +155,14 @@ namespace CUE.NET.Native
             return _corsairSetLedsColorsPointer(size, ledsColors);
         }
 
+        /// <summary>
+        /// CUE-SDK: get current color for the list of requested LEDs.
+        /// </summary>
+        internal static bool CorsairGetLedsColors(int size, IntPtr ledsColors)
+        {
+            return _corsairGetLedsColorsPointer(size, ledsColors);
+        }
+
         /// <summary>
         /// CUE-SDK: returns number of connected Corsair devices that support lighting control.
         /// </summary>
@@ -206,6 +236,11 @@ namespace CUE.NET.Native
             return _corsairGetLastErrorPointer();
         }
 
+        internal static bool CorsairRegisterKeypressCallback(IntPtr callback, IntPtr context)
+        {
+            return _corsairRegisterKeypressCallbackPointer(callback, context);
+        }
+
         // ReSharper restore EventExceptionNotDocumented
 
         #endregion

Properties/AssemblyInfo.cs

@@ -31,5 +31,5 @@ using System.Runtime.InteropServices;
 // You can specify all the values or you can default the Build and Revision Numbers 
 // by using the '*' as shown below:
 // [assembly: AssemblyVersion("1.0.*")]
-[assembly: AssemblyVersion("1.1.3.0")]
+[assembly: AssemblyVersion("1.2.0.1")]
-[assembly: AssemblyFileVersion("1.1.3.0")]
+[assembly: AssemblyFileVersion("1.2.0.1")]

README.md

@@ -1,3 +1,6 @@
+**CUE.NET is considered done now and will be no longer actively developed.   
+It is superseded by [RGB.NET](https://github.com/DarthAffe/RGB.NET). Feel free to join the [discord-channel](https://discord.gg/9kytURv) if you're interested what's happening there :)**
+
 # CUE.NET
 C# (.NET) Wrapper library around the Corsair CUE-SDK