Windows 11 future version - September 2024 Samples Update

oldnewthing · oldnewthing · commit 61b4d3270232 · 2024-09-18T17:00:19.000-07:00
* PowerGrid: Fix divide by zero error
* WebSocket: Use a script to generate the certificates and private keys
* LampArray: New LampArray.IsAvailable property
diff --git a/.gitignore b/.gitignore
@@ -203,4 +203,6 @@ FakesAssemblies/
 
 # Custom ignores
 gallery.xml
-project.lock.json
+project.lock.json
+Samples/WebSocket/server/WebSocketSampleScriptSettings
+Samples/StreamSocket/**/StreamSocketSampleScriptSettings.xml
diff --git a/Samples/LampArray/cppwinrt/SampleConfiguration.cpp b/Samples/LampArray/cppwinrt/SampleConfiguration.cpp
@@ -18,7 +18,7 @@ using namespace winrt::SDKTemplate;
 using namespace winrt::Windows::Devices::Lights;
 using namespace winrt::Windows::Foundation::Collections;
 
-hstring winrt::to_hstring(LampArrayKind lampArrayKind)
+std::wstring std::to_wstring(LampArrayKind lampArrayKind)
 {
     switch (lampArrayKind)
     {
@@ -44,7 +44,8 @@ hstring winrt::to_hstring(LampArrayKind lampArrayKind)
         return L"Art";
     case LampArrayKind::Undefined:
     default:
-        return L"Unknown LampArrayKind";
+        // Additional lamp array kinds can be looked up in the USB HID specification.
+        return std::to_wstring(static_cast<uint32_t>(lampArrayKind));
     }
 }
 
diff --git a/Samples/LampArray/cppwinrt/SampleConfiguration.h b/Samples/LampArray/cppwinrt/SampleConfiguration.h
@@ -12,9 +12,9 @@
 #pragma once
 #include "pch.h"
 
-namespace winrt
+namespace std
 {
-    hstring to_hstring(winrt::Windows::Devices::Lights::LampArrayKind lampArrayKind);
+    std::wstring to_wstring(winrt::Windows::Devices::Lights::LampArrayKind lampArrayKind);
 }
 
 namespace winrt::SDKTemplate
@@ -29,5 +29,7 @@ namespace winrt::SDKTemplate
         winrt::hstring const id;
         winrt::hstring const displayName;
         winrt::Windows::Devices::Lights::LampArray const lampArray;
+
+        winrt::Windows::Devices::Lights::LampArray::AvailabilityChanged_revoker availabilityChangedRevoker;
     };
 }
diff --git a/Samples/LampArray/cppwinrt/Scenario1_Basics.cpp b/Samples/LampArray/cppwinrt/Scenario1_Basics.cpp
@@ -70,6 +70,10 @@ namespace winrt::SDKTemplate::implementation
             co_return;
         }
 
+        // Set up the AvailabilityChanged event callback for being notified whether this process can control
+        // RGB lighting for the newly attached LampArray.
+        info->availabilityChangedRevoker = info->lampArray.AvailabilityChanged(winrt::auto_revoke, { this, &Scenario1_Basics::LampArray_AvailabilityChanged });
+
         // Remember this new LampArray and add it to the list.
         m_attachedLampArrays.push_back(std::move(info));
         UpdateLampArrayList();
@@ -91,14 +95,24 @@ namespace winrt::SDKTemplate::implementation
         UpdateLampArrayList();
     }
 
+    // The AvailabilityChanged event will fire when this calling process gains or loses control of RGB lighting
+    // for the specified LampArray.
+    winrt::fire_and_forget Scenario1_Basics::LampArray_AvailabilityChanged(const LampArray& sender, const IInspectable&)
+    {
+        co_await winrt::resume_foreground(Dispatcher());
+
+        UpdateLampArrayList();
+    }
+
     void Scenario1_Basics::UpdateLampArrayList()
     {
         std::wstring message = std::wstring(L"Attached LampArrays: ") + std::to_wstring(m_attachedLampArrays.size()) + L"\n";
 
         for (auto&& info : m_attachedLampArrays)
         {
             message += std::wstring(L"\t") + std::wstring(info->displayName) + L" ("
-                + winrt::to_hstring(info->lampArray.LampArrayKind()) + L", " + std::to_wstring(info->lampArray.LampCount()) + L" lamps)\n";
+                + std::to_wstring(info->lampArray.LampArrayKind()) + L", " + std::to_wstring(info->lampArray.LampCount()) + L" lamps, "
+                + std::wstring(info->lampArray.IsAvailable() ? L"Available" : L"Unavailable") + L")\n";
         }
 
         LampArraysSummary().Text(message);
diff --git a/Samples/LampArray/cppwinrt/Scenario1_Basics.h b/Samples/LampArray/cppwinrt/Scenario1_Basics.h
@@ -45,6 +45,10 @@ namespace winrt::SDKTemplate::implementation
             winrt::Windows::Devices::Enumeration::DeviceWatcher const&,
             winrt::Windows::Devices::Enumeration::DeviceInformationUpdate deviceInformationUpdate);
 
+        winrt::fire_and_forget LampArray_AvailabilityChanged(
+            winrt::Windows::Devices::Lights::LampArray const& sender,
+            winrt::Windows::Foundation::IInspectable const&);
+
         void UpdateLampArrayList();
 
         void ApplySettingsToLampArray(winrt::Windows::Devices::Lights::LampArray const& lampArray);
diff --git a/Samples/LampArray/cppwinrt/Scenario2_Effects.cpp b/Samples/LampArray/cppwinrt/Scenario2_Effects.cpp
@@ -91,6 +91,10 @@ namespace winrt::SDKTemplate::implementation
         // Initial condition for the new LampArray is all lights off.
         info->lampArray.SetColor(Colors::Black());
 
+        // Set up the AvailabilityChanged event callback for being notified whether this process can control
+        // RGB lighting for the newly attached LampArray.
+        info->availabilityChangedRevoker = info->lampArray.AvailabilityChanged(winrt::auto_revoke, { this, &Scenario2_Effects::LampArray_AvailabilityChanged });
+
         m_attachedLampArrays.push_back(std::move(info));
 
         UpdateLampArrayList();
@@ -112,14 +116,24 @@ namespace winrt::SDKTemplate::implementation
         UpdateLampArrayList();
     }
 
+    // The AvailabilityChanged event will fire when this calling process gains or loses control of RGB lighting
+    // for the specified LampArray.
+    winrt::fire_and_forget Scenario2_Effects::LampArray_AvailabilityChanged(const LampArray& sender, const IInspectable&)
+    {
+        co_await winrt::resume_foreground(Dispatcher());
+
+        UpdateLampArrayList();
+    }
+
     void Scenario2_Effects::UpdateLampArrayList()
     {
         std::wstring message = std::wstring(L"Attached LampArrays: ") + std::to_wstring(m_attachedLampArrays.size()) + L"\n";
 
         for (auto&& info : m_attachedLampArrays)
         {
             message += L"\t" + info->displayName + L" ("
-                + winrt::to_hstring(info->lampArray.LampArrayKind()) + L", " + std::to_wstring(info->lampArray.LampCount()) + L" lamps)\n";
+                + std::to_wstring(info->lampArray.LampArrayKind()) + L", " + std::to_wstring(info->lampArray.LampCount()) + L" lamps, "
+                + std::wstring(info->lampArray.IsAvailable() ? L"Available" : L"Unavailable") + L")\n";
         }
 
         LampArraysSummary().Text(message);
diff --git a/Samples/LampArray/cppwinrt/Scenario2_Effects.h b/Samples/LampArray/cppwinrt/Scenario2_Effects.h
@@ -125,6 +125,10 @@ namespace winrt::SDKTemplate::implementation
             winrt::Windows::Devices::Enumeration::DeviceWatcher const&,
             winrt::Windows::Devices::Enumeration::DeviceInformationUpdate deviceInformationUpdate);
 
+        winrt::fire_and_forget LampArray_AvailabilityChanged(
+            winrt::Windows::Devices::Lights::LampArray const& sender,
+            winrt::Windows::Foundation::IInspectable const&);
+
         void UpdateLampArrayList();
         void CleanupPreviousEffect();
 
diff --git a/Samples/LampArray/cs/Scenario1_Basics.xaml.cs b/Samples/LampArray/cs/Scenario1_Basics.xaml.cs
@@ -72,6 +72,10 @@ await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
                     return;
                 }
 
+                // Set up the AvailabilityChanged event callback for being notified whether this process can control
+                // RGB lighting for the newly attached LampArray.
+                info.lampArray.AvailabilityChanged += LampArray_AvailabilityChanged;
+
                 // Remember this new LampArray and add it to the list.
                 m_attachedLampArrays.Add(info);
                 UpdateLampArrayList();
@@ -90,12 +94,23 @@ await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
             });
         }
 
+        // The AvailabilityChanged event will fire when this calling process gains or loses control of RGB lighting
+        // for the specified LampArray.
+        private async void LampArray_AvailabilityChanged(LampArray sender, object args)
+        {
+            await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
+            {
+                UpdateLampArrayList();
+            });
+        }
+
         private void UpdateLampArrayList()
         {
             string message = $"Attached LampArrays: {m_attachedLampArrays.Count}\n";
             foreach (LampArrayInfo info in m_attachedLampArrays)
             {
-                message += $"\t{info.displayName} ({info.lampArray.LampArrayKind}, {info.lampArray.LampCount} lamps)\n";
+                message += $"\t{info.displayName} ({info.lampArray.LampArrayKind.ToString()}, {info.lampArray.LampCount} lamps, " +
+                           $"{(info.lampArray.IsAvailable ? "Available" : "Unavailable")})\n";
             }
             LampArraysSummary.Text = message;
         }
diff --git a/Samples/LampArray/cs/Scenario2_Effects.xaml.cs b/Samples/LampArray/cs/Scenario2_Effects.xaml.cs
@@ -125,6 +125,10 @@ await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
                 // Initial condition for the new LampArray is all lights off.
                 info.lampArray.SetColor(Colors.Black);
 
+                // Set up the AvailabilityChanged event callback for being notified whether this process can control
+                // RGB lighting for the newly attached LampArray.
+                info.lampArray.AvailabilityChanged += LampArray_AvailabilityChanged;
+
                 m_attachedLampArrays.Add(info);
 
                 UpdateLampArrayList();
@@ -143,12 +147,23 @@ await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
             });
         }
 
+        // The AvailabilityChanged event will fire when this calling process gains or loses control of RGB lighting
+        // for the specified LampArray.
+        private async void LampArray_AvailabilityChanged(LampArray sender, object args)
+        {
+            await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
+            {
+                UpdateLampArrayList();
+            });
+        }
+
         private void UpdateLampArrayList()
         {
             string message = $"Attached LampArrays: {m_attachedLampArrays.Count}\n";
             foreach (LampArrayInfo info in m_attachedLampArrays)
             {
-                message += $"\t{info.displayName} ({info.lampArray.LampArrayKind.ToString()}, {info.lampArray.LampCount} lamps)\n";
+                message += $"\t{info.displayName} ({info.lampArray.LampArrayKind.ToString()}, {info.lampArray.LampCount} lamps, " +
+                           $"{(info.lampArray.IsAvailable ? "Available" : "Unavailable")})\n";
             }
             LampArraysSummary.Text = message;
         }
diff --git a/Samples/PowerGrid/README.md b/Samples/PowerGrid/README.md
@@ -1,19 +1,76 @@
-# PowerGrid API usage sample
-------------------------------
+---
+page_type: sample
+languages:
+- csharp
+- cpp
+- cppwinrt
+products:
+- windows
+- windows-uwp
+urlFragment: PowerGrid
+extendedZipContent:
+- path: SharedContent
+  target: SharedContent
+- path: LICENSE
+  target: LICENSE
+description: "Shows how to use power grid forecasts."
+---
+
+# Power grid forecast sample
+
+> **Note:** This sample is part of a large collection of UWP feature samples. 
+> You can download this sample as a standalone ZIP file
+> [from docs.microsoft.com](https://docs.microsoft.com/samples/microsoft/windows-universal-samples/resizeappview/),
+> or you can download the entire collection as a single
+> [ZIP file](https://github.com/Microsoft/Windows-universal-samples/archive/master.zip), but be 
+> sure to unzip everything to access shared dependencies. For more info on working with the ZIP file, 
+> the samples collection, and GitHub, see [Get the UWP samples from GitHub](https://aka.ms/ovu2uq). 
+> For more samples, see the [Samples portal](https://aka.ms/winsamples) on the Windows Dev Center. 
+
 Shows how to use the PowerGrid Forecast API.
 
 This sample covers the following:
-- Obtaining the PowerGrid Forecast
+- Obtaining the power grid forecast
 - Registering for ForecastUpdated notifications
 - Looking for the lowest severity in a specified timeframe
 
-## Requirements
-- Visual Studio 2022
-- Windows 11 SDK
-- Windows 11
+**Note** The Windows universal samples require Visual Studio to build and Windows 11 to execute.
+ 
+To obtain information about Windows development, go to the [Windows Dev Center](http://go.microsoft.com/fwlink/?LinkID=532421)
+
+To obtain information about Microsoft Visual Studio and the tools for developing Windows apps, go to [Visual Studio](http://go.microsoft.com/fwlink/?LinkID=532422)
+
+## Related topics
+
+### Reference
+
+[PowerGridForecast class](https://learn.microsoft.com/uwp/api/windows.devices.power.powergridforecast)
+
+### Related samples
+
+[Power grid forecast from a Win32 app](https://github.com/microsoft/Windows-classic-samples/tree/main/Samples/PowerGrid)
+
+## System requirements
+
+- Windows 11 SDK (build 26100 or higher)
+- Windows 11 (build 26100 or higher)
 
 ## Build the sample
-Open the solution in Visual Studio 2022 and build. 
+
+1. If you download the samples ZIP, be sure to unzip the entire archive, not just the folder with the sample you want to build. 
+2. Start Microsoft Visual Studio and select **File** \> **Open** \> **Project/Solution**.
+3. Starting in the folder where you unzipped the samples, go to the Samples subfolder, then the subfolder for this specific sample, then the subfolder for your preferred language (C++, C#, or JavaScript). Double-click the Visual Studio Solution (.sln) file.
+4. Press Ctrl+Shift+B, or select **Build** \> **Build Solution**.
 
 ## Run the sample
-Run from within Visual Studio or open Windows Terminal and navigate to the directory with the built executable. From the terminal run `PowerGrid.exe`.
+
+The next steps depend on whether you just want to deploy the sample or you want to both deploy and run it.
+
+### Deploying the sample
+
+- Select Build > Deploy Solution. 
+
+### Deploying and running the sample
+
+- To debug the sample and then run it, press F5 or select Debug >  Start Debugging. To run the sample without debugging, press Ctrl+F5 or select Debug > Start Without Debugging. 
+
diff --git a/Samples/PowerGrid/cppwinrt/Scenario1_FindBest.cpp b/Samples/PowerGrid/cppwinrt/Scenario1_FindBest.cpp
@@ -54,6 +54,13 @@ namespace winrt::SDKTemplate::implementation
     int Scenario1_FindBest::GetForecastIndexContainingTime(PowerGridForecast const& gridForecast, DateTime time)
     {
         TimeSpan blockDuration = gridForecast.BlockDuration();
+
+        // Avoid division by zero.
+        if (blockDuration.count() == 0)
+        {
+            return 0;
+        }
+
         auto startBlock = static_cast<int>((time - gridForecast.StartTime()) / blockDuration);
         return std::clamp(startBlock, 0, static_cast<int>(gridForecast.Forecast().Size()));
     }
diff --git a/Samples/PowerGrid/cs/Scenario1_FindBest.xaml.cs b/Samples/PowerGrid/cs/Scenario1_FindBest.xaml.cs
@@ -54,6 +54,12 @@ private int GetForecastIndexContainingTime(PowerGridForecast gridForecast, DateT
         {
             TimeSpan blockDuration = gridForecast.BlockDuration;
 
+            // Avoid division by zero.
+            if (blockDuration == TimeSpan.Zero)
+            {
+                return 0;
+            }
+
             long startBlock = (time - gridForecast.StartTime).Ticks / blockDuration.Ticks;
             return (int)Math.Max(0, Math.Min(startBlock, gridForecast.Forecast.Count));
         }
diff --git a/Samples/WebSocket/README.md b/Samples/WebSocket/README.md
@@ -95,9 +95,10 @@ This sample requires that network capabilities be set in the *Package.appxmanife
 ## Build the sample
 
 1. If you download the samples ZIP, be sure to unzip the entire archive, not just the folder with the sample you want to build. 
-2. Start Microsoft Visual Studio and select **File** \> **Open** \> **Project/Solution**.
-3. Starting in the folder where you unzipped the samples, go to the Samples subfolder, then the subfolder for this specific sample, then the subfolder for your preferred language (C++, C#, or JavaScript). Double-click the Visual Studio Solution (.sln) file.
-4. Press Ctrl+Shift+B, or select **Build** \> **Build Solution**.
+2. **Important**: From an elevated Powershell command prompt, navigate to the `WebSocket/shared` folder and execute the Powershell script `.\\clientCertGenerator.ps1`, This script will generate a custom RootCert.cer and clientCert.pfx, which are required for the application and server.
+3. Start Microsoft Visual Studio and select **File** \> **Open** \> **Project/Solution**.
+4. Starting in the folder where you unzipped the samples, go to the Samples subfolder, then the subfolder for this specific sample, then the subfolder for your preferred language (C++, C++/WinRT, C#). Double-click the Visual Studio Solution (.sln) file.
+5. Press Ctrl+Shift+B, or select **Build** \> **Build Solution**.
 
 ## Run the sample
 
diff --git a/Samples/WebSocket/cpp/WebSocket.vcxproj b/Samples/WebSocket/cpp/WebSocket.vcxproj
@@ -236,4 +236,7 @@
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
   <ImportGroup Label="ExtensionTargets">
   </ImportGroup>
+  <Target Name="CheckCertificates" BeforeTargets="PrepareForBuild">
+    <Error Condition="!Exists('$(MSBuildThisFileDirectory)\..\shared\clientCert.pfx')" Text="Before building this project, run the clientCertGenerator.ps1 script elevated as described in the README.md."/>
+  </Target>
 </Project>
diff --git a/Samples/WebSocket/cppwinrt/WebSocket.vcxproj b/Samples/WebSocket/cppwinrt/WebSocket.vcxproj
@@ -196,6 +196,9 @@
   <ImportGroup Label="ExtensionTargets">
     <Import Project="packages\Microsoft.Windows.CppWinRT.2.0.200703.9\build\native\Microsoft.Windows.CppWinRT.targets" Condition="Exists('packages\Microsoft.Windows.CppWinRT.2.0.200703.9\build\native\Microsoft.Windows.CppWinRT.targets')" />
   </ImportGroup>
+  <Target Name="CheckCertificates" BeforeTargets="PrepareForBuild">
+    <Error Condition="!Exists('$(MSBuildThisFileDirectory)\..\shared\clientCert.pfx')" Text="Before building this project, run the clientCertGenerator.ps1 script elevated as described in the README.md."/>
+  </Target>
   <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>
diff --git a/Samples/WebSocket/cs/WebSocket.csproj b/Samples/WebSocket/cs/WebSocket.csproj
@@ -205,10 +205,11 @@
     <VisualStudioVersion>14.0</VisualStudioVersion>
   </PropertyGroup>
   <Import Project="$(MSBuildExtensionsPath)\Microsoft\WindowsXaml\v$(VisualStudioVersion)\Microsoft.Windows.UI.Xaml.CSharp.targets" />
-  <!-- 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.
   <Target Name="BeforeBuild">
+    <Error Condition="!Exists('$(MSBuildThisFileDirectory)\..\shared\clientCert.pfx')" Text="Before building this project, run the clientCertGenerator.ps1 script as described in the README.md."/>
   </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.
   <Target Name="AfterBuild">
   </Target>
   -->
diff --git a/Samples/WebSocket/server/RootCert.cer b/Samples/WebSocket/server/RootCert.cer
diff --git a/Samples/WebSocket/server/WebSocketSampleScriptSettings b/Samples/WebSocket/server/WebSocketSampleScriptSettings
diff --git a/Samples/WebSocket/server/setupserver.ps1 b/Samples/WebSocket/server/setupserver.ps1
@@ -19,6 +19,7 @@ $wssFirewallRuleName = "WebSocketSample - HTTPS 443"
 $requiredFeatures = "IIS-WebServer", "IIS-WebServerRole", "NetFx4Extended-ASPNET45", "IIS-ApplicationDevelopment", "IIS-ASPNET45", "IIS-ISAPIExtensions", "IIS-ISAPIFilter", "IIS-NetFxExtensibility45", "IIS-WebSockets"
 $settings = @{"featuresToEnable"=@(); "serverCertificateThumbprint"=""; "clientRootCertThumbprint" = ""; "webBindingAdded"=$false; "oldDefaultCert"=""}
 $settingsFile = "$scriptPath\WebSocketSampleScriptSettings"
+$rootCertFile = "$scriptPath\Rootcert.cer"
 
 # Check if running as Administrator.
 $windowsIdentity = [System.Security.Principal.WindowsIdentity]::GetCurrent()
@@ -37,6 +38,13 @@ if (Test-Path $settingsFile)
     return;
 }
 
+# Check if the necessary certificates have been created. If not, then user should run the certificate scripts first.
+if (Test-Path $rootCertFile)
+{
+    "You need to run the ..\shared\clientCertGenerator.ps1 script to create the certificates before running this script."
+    return;
+}
+
 # Get features that should be enabled.
 $featuresToEnable = @()
 Get-WindowsOptionalFeature -Online | ?{ $_.State -eq [Microsoft.Dism.Commands.FeatureState]::Disabled -and $requiredFeatures -contains $_.FeatureName } | %{ $featuresToEnable += $_.FeatureName }
diff --git a/Samples/WebSocket/shared/clientCert.pfx b/Samples/WebSocket/shared/clientCert.pfx
diff --git a/Samples/WebSocket/shared/clientCertGenerator.ps1 b/Samples/WebSocket/shared/clientCertGenerator.ps1

Original file line number	Diff line number	Diff line change
`@@ -18,7 +18,7 @@ using namespace winrt::SDKTemplate;`
`18`	`18`	`using namespace winrt::Windows::Devices::Lights;`
`19`	`19`	`using namespace winrt::Windows::Foundation::Collections;`
`20`	`20`
`21`		`-hstring winrt::to_hstring(LampArrayKind lampArrayKind)`
	`21`	`+std::wstring std::to_wstring(LampArrayKind lampArrayKind)`
`22`	`22`	`{`
`23`	`23`	`switch (lampArrayKind)`
`24`	`24`	`{`
`@@ -44,7 +44,8 @@ hstring winrt::to_hstring(LampArrayKind lampArrayKind)`
`44`	`44`	`return L"Art";`
`45`	`45`	`case LampArrayKind::Undefined:`
`46`	`46`	`default:`
`47`		`- return L"Unknown LampArrayKind";`
	`47`	`+ // Additional lamp array kinds can be looked up in the USB HID specification.`
	`48`	`+ return std::to_wstring(static_cast<uint32_t>(lampArrayKind));`
`48`	`49`	`}`
`49`	`50`	`}`
`50`	`51`
Original file line number	Diff line number	Diff line change
`@@ -12,9 +12,9 @@`
`12`	`12`	`#pragma once`
`13`	`13`	`#include "pch.h"`
`14`	`14`
`15`		`-namespace winrt`
	`15`	`+namespace std`
`16`	`16`	`{`
`17`		`- hstring to_hstring(winrt::Windows::Devices::Lights::LampArrayKind lampArrayKind);`
	`17`	`+ std::wstring to_wstring(winrt::Windows::Devices::Lights::LampArrayKind lampArrayKind);`
`18`	`18`	`}`
`19`	`19`
`20`	`20`	`namespace winrt::SDKTemplate`
`@@ -29,5 +29,7 @@ namespace winrt::SDKTemplate`
`29`	`29`	`winrt::hstring const id;`
`30`	`30`	`winrt::hstring const displayName;`
`31`	`31`	`winrt::Windows::Devices::Lights::LampArray const lampArray;`
	`32`	`+`
	`33`	`+ winrt::Windows::Devices::Lights::LampArray::AvailabilityChanged_revoker availabilityChangedRevoker;`
`32`	`34`	`};`
`33`	`35`	`}`
Original file line number	Diff line number	Diff line change
`@@ -72,6 +72,10 @@ await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>`
`72`	`72`	`return;`
`73`	`73`	`}`
`74`	`74`
	`75`	`+ // Set up the AvailabilityChanged event callback for being notified whether this process can control`
	`76`	`+ // RGB lighting for the newly attached LampArray.`
	`77`	`+ info.lampArray.AvailabilityChanged += LampArray_AvailabilityChanged;`
	`78`	`+`
`75`	`79`	`// Remember this new LampArray and add it to the list.`
`76`	`80`	`m_attachedLampArrays.Add(info);`
`77`	`81`	`UpdateLampArrayList();`
`@@ -90,12 +94,23 @@ await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>`
`90`	`94`	`});`
`91`	`95`	`}`
`92`	`96`
	`97`	`+ // The AvailabilityChanged event will fire when this calling process gains or loses control of RGB lighting`
	`98`	`+ // for the specified LampArray.`
	`99`	`+ private async void LampArray_AvailabilityChanged(LampArray sender, object args)`
	`100`	`+ {`
	`101`	`+ await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>`
	`102`	`+ {`
	`103`	`+ UpdateLampArrayList();`
	`104`	`+ });`
	`105`	`+ }`
	`106`	`+`
`93`	`107`	`private void UpdateLampArrayList()`
`94`	`108`	`{`
`95`	`109`	`string message = $"Attached LampArrays: {m_attachedLampArrays.Count}\n";`
`96`	`110`	`foreach (LampArrayInfo info in m_attachedLampArrays)`
`97`	`111`	`{`
`98`		`- message += $"\t{info.displayName} ({info.lampArray.LampArrayKind}, {info.lampArray.LampCount} lamps)\n";`
	`112`	`+ message += $"\t{info.displayName} ({info.lampArray.LampArrayKind.ToString()}, {info.lampArray.LampCount} lamps, " +`
	`113`	`+ $"{(info.lampArray.IsAvailable ? "Available" : "Unavailable")})\n";`
`99`	`114`	`}`
`100`	`115`	`LampArraysSummary.Text = message;`
`101`	`116`	`}`