From 69510e728f4c45859dcabec8aae1d787a8303643 Mon Sep 17 00:00:00 2001 From: guimafelipe Date: Fri, 20 Feb 2026 13:33:00 -0800 Subject: [PATCH 1/2] Add WCR platform requirements documenting x86 not supported --- docs/wcr-platform-requirements.md | 41 +++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 docs/wcr-platform-requirements.md diff --git a/docs/wcr-platform-requirements.md b/docs/wcr-platform-requirements.md new file mode 100644 index 0000000000..9489e2e25b --- /dev/null +++ b/docs/wcr-platform-requirements.md @@ -0,0 +1,41 @@ +# Windows Copilot Runtime (WCR) Platform Requirements + +## Supported Architectures + +Windows Copilot Runtime APIs are supported on the following architectures: + +| Architecture | Supported | +|-------------|-----------| +| **x64** | Yes | +| **ARM64** | Yes | +| **x86** | No | + +x86 applications will receive `REGDB_E_CLASSNOTREG (0x80040154)` at runtime +when attempting to call WCR APIs such as `GetReadyState()`. There is no plan +to add x86 support at this time. + +If your application targets x86, you should either: +- Retarget to x64 or ARM64 to use WCR features. +- Guard WCR API calls with architecture checks and provide alternative + behavior for x86 builds. + +## Hardware Requirements + +WCR features require **Copilot+ PC** hardware with a Neural Processing Unit +(NPU). On devices without the required hardware, `GetReadyState()` will return +`NotReady` or `Unavailable`. + +## Affected APIs + +The following WCR APIs are subject to these platform requirements: + +- `Microsoft.Windows.AI.Generative.LanguageModel` (Phi Silica) +- `Microsoft.Windows.AI.Generative.ImageDescriptionGenerator` +- `Microsoft.Windows.AI.Imaging.ImageSuperResolution` +- `Microsoft.Windows.AI.ContentModeration.TextRecognizer` + +## OS Requirements + +- Windows 11 with Copilot+ capable hardware +- Appropriate Windows Update servicing updates installed +- AI model packages available via Windows Update From 4996c0dbb2703029167c5c224c3e2a7769992643 Mon Sep 17 00:00:00 2001 From: Lauren Ciha Date: Fri, 20 Feb 2026 17:35:52 -0800 Subject: [PATCH 2/2] Revise Windows AI Platform requirements documentation Updated document to reflect the new naming convention from 'Windows Copilot Runtime' to 'Windows AI Platform'. Removed outdated API list and added a new section for getting started. --- ...md => windows-ai-platform-requirements.md} | 20 +++++++------------ 1 file changed, 7 insertions(+), 13 deletions(-) rename docs/{wcr-platform-requirements.md => windows-ai-platform-requirements.md} (55%) diff --git a/docs/wcr-platform-requirements.md b/docs/windows-ai-platform-requirements.md similarity index 55% rename from docs/wcr-platform-requirements.md rename to docs/windows-ai-platform-requirements.md index 9489e2e25b..7af9ad0252 100644 --- a/docs/wcr-platform-requirements.md +++ b/docs/windows-ai-platform-requirements.md @@ -1,8 +1,8 @@ -# Windows Copilot Runtime (WCR) Platform Requirements +# Windows AI Platform Requirements ## Supported Architectures -Windows Copilot Runtime APIs are supported on the following architectures: +Windows AI APIs are supported on the following architectures: | Architecture | Supported | |-------------|-----------| @@ -23,19 +23,13 @@ If your application targets x86, you should either: WCR features require **Copilot+ PC** hardware with a Neural Processing Unit (NPU). On devices without the required hardware, `GetReadyState()` will return -`NotReady` or `Unavailable`. - -## Affected APIs - -The following WCR APIs are subject to these platform requirements: - -- `Microsoft.Windows.AI.Generative.LanguageModel` (Phi Silica) -- `Microsoft.Windows.AI.Generative.ImageDescriptionGenerator` -- `Microsoft.Windows.AI.Imaging.ImageSuperResolution` -- `Microsoft.Windows.AI.ContentModeration.TextRecognizer` +`NotSupportedOnCurrentSystem` (see return type [AIReadyState documentation]([url](https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.ai.aifeaturereadystate?view=windows-app-sdk-1.8)) for more info. ## OS Requirements - Windows 11 with Copilot+ capable hardware - Appropriate Windows Update servicing updates installed -- AI model packages available via Windows Update +- [AI model packages available via Windows Update](https://learn.microsoft.com/en-us/windows/release-health/ai-components-release-information) + +## Ready to Get Started? +Check out [Get started building an app with Windows AI APIs](https://learn.microsoft.com/en-us/windows/ai/apis/get-started?tabs=winget%2Cwinui%2Cwinui2) on Microsoft Learn.