Partilhar via


Instalar o WDK usando o WinGet

Você pode usar a ferramenta Gerenciador de Pacotes do Windows (WinGet) para instalar ou atualizar o Kit de Driver do Windows em seu computador, junto com suas dependências, como o Visual Studio e o Windows Software Development Kit, tudo a partir da linha de comando.

Consulte a documentação de instalação do WinGet se precisar de ajuda para certificar-se de que o WinGet esteja instalado e configurado corretamente.

Instalação passo a passo do mais recente WDK usando o WinGet

A versão mais recente do WDK é 10.0.26100.1591. Ele requer o Visual Studio 2022 e o SDK do Windows 10.0.26100.1 Para obter mais informações, consulte Controle de versão de kits.

Etapa 1: Instalar o Visual Studio 2022

O WDK requer o Visual Studio 2022 com a carga de trabalho Desenvolvimento para desktop com C++ instalada, além das Ferramentas de build VS 2022 C++ e seus componentes de Bibliotecas mitigadas por espectro de VS 2022 C++ (mais recentes) correspondentes para cada arquitetura para a qual você pretende criar drivers.

Você pode usar o WinGet para instalar o Visual Studio 2022 com todas as cargas de trabalho e componentes necessários para o desenvolvimento de drivers. Para fazer isso, você precisa de um arquivo de configuração de instalação do Visual Studio. Crie um arquivo wdk.vsconfig com o seguinte conteúdo e anote sua localização:

{
  "version": "1.0",
  "components": [
    "Microsoft.Component.MSBuild",
    "Microsoft.VisualStudio.Component.CoreEditor",
    "Microsoft.VisualStudio.Component.NuGet",
    "Microsoft.VisualStudio.Component.Roslyn.Compiler",
    "Microsoft.VisualStudio.Component.TextTemplating",
    "Microsoft.VisualStudio.Component.VC.ASAN",
    "Microsoft.VisualStudio.Component.VC.ATL.ARM64.Spectre",
    "Microsoft.VisualStudio.Component.VC.ATL.ARM64",
    "Microsoft.VisualStudio.Component.VC.ATL.Spectre",
    "Microsoft.VisualStudio.Component.VC.ATL",
    "Microsoft.VisualStudio.Component.VC.ATLMFC.Spectre",
    "Microsoft.VisualStudio.Component.VC.ATLMFC",
    "Microsoft.VisualStudio.Component.VC.CoreIde",
    "Microsoft.VisualStudio.Component.VC.MFC.ARM64.Spectre",
    "Microsoft.VisualStudio.Component.VC.MFC.ARM64",
    "Microsoft.VisualStudio.Component.VC.Redist.14.Latest",
    "Microsoft.VisualStudio.Component.VC.Runtimes.ARM64.Spectre",
    "Microsoft.VisualStudio.Component.VC.Runtimes.ARM64EC.Spectre",
    "Microsoft.VisualStudio.Component.VC.Runtimes.x86.x64.Spectre",
    "Microsoft.VisualStudio.Component.VC.Tools.ARM64",
    "Microsoft.VisualStudio.Component.VC.Tools.ARM64EC",
    "Microsoft.VisualStudio.Component.VC.Tools.x86.x64",
    "Microsoft.VisualStudio.Component.Windows10SDK",
    "Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core",
    "Microsoft.VisualStudio.Workload.CoreEditor",
    "Microsoft.VisualStudio.Workload.NativeDesktop"
  ]
}

Dependendo da edição que deseja instalar, você precisará fornecer winget com um conjunto diferente de parâmetros do instalador junto com o caminho para o arquivo .vsconfig que você acabou de criar para personalizar sua instalação.

Cuidado

Você deve fornecer um caminho absoluto para o arquivo wdk.vsconfig nos comandos a seguir. Caso contrário, o WinGet poderá falhar ao instalar o Visual Studio enquanto ainda relata êxito.

Visual Studio Community 2022:

winget install --source winget --exact --id Microsoft.VisualStudio.2022.Community --override "--passive --config <vsconfig-folder>\wdk.vsconfig"

Visual Studio Professional 2022:

winget install --source winget --exact --id Microsoft.VisualStudio.2022.Professional --override "--passive --config <vsconfig-folder>\wdk.vsconfig""

Visual Studio Enterprise 2022:

winget install --source winget --exact --id Microsoft.VisualStudio.2022.Enterprise --override "--passive --config <vsconfig-folder>\wdk.vsconfig"

Você pode verificar a documentação do Visual Studio sobre Como usar o WinGet para instalar ou modificar o Visual Studio para obter mais detalhes.

Etapa 2: Instalar o SDK do Windows e o WDK

Você pode instalar o SDK do Windows e o WDK do WinGet executando os seguintes comandos:

SDK do Windows:

winget install --source winget --exact --id Microsoft.WindowsSDK.10.0.26100 --log $env:USERPROFILE/Desktop/sdk-install.log

WDK do Windows:

winget install --source winget --exact --id Microsoft.WindowsWDK.10.0.26100 --log $env:USERPROFILE/Desktop/wdk-install.log

Se você estiver usando o VS 17.11.0 ou posterior, desmarque a caixa de seleção instalar extensão.

Passo 3: Instale a extensão do WDK Visual Studio

Observação

Esta seção só é um aplicativo ao usar o VS anterior à versão 17.11.0

Depois de instalar o WDK a partir da linha de comando, você precisará instalar a extensão do Windows Driver Kit Visual Studio separadamente para poder criar e testar drivers. Por padrão, a extensão está localizada em %ProgramFiles(x86)%\Windows Kits\10\Vsix\VS2022\10.0.26100.0\%PROCESSOR_ARCHITECTURE%\WDK.vsix.

Usar o Prompt de Comando:

for /f "usebackq tokens=*" %i in (`"%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere.exe" -nologo -latest -products * -property enginePath`) do (
  "%i\VSIXInstaller.exe" "%ProgramFiles(x86)%\Windows Kits\10\Vsix\VS2022\10.0.26100.0\%PROCESSOR_ARCHITECTURE%\WDK.vsix"
)

Usar o PowerShell:

& $(& "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe" -nologo -latest -products * -property enginePath | Join-Path -ChildPath 'VSIXInstaller.exe') "${env:ProgramFiles(x86)}\Windows Kits\10\Vsix\VS2022\10.0.26100.0\${env:PROCESSOR_ARCHITECTURE}\WDK.vsix"

Instalar outras versões do WDK usando o WinGet

Você pode instalar vários kits para diferentes versões do Windows a partir do WinGet.

Observação

Para versões 22000 (destinadas ao Windows 11, versão 21H2) e mais antigas, você precisa instalar uma versão mais antiga do Visual Studio. Consulte Outros downloads do WDK > Etapa 1: Instalar o Visual Studio para localizar a versão necessária do Visual Studio para a versão do WDK que você deseja instalar.

Você pode procurar outras versões de kit disponíveis usando o comando winget search.

SDK do Windows:

winget search --source winget --id Microsoft.WindowsSDK

WDK do Windows:

winget search --source winget --id Microsoft.WindowsWDK

Cada comando retornará uma tabela com todas as versões disponíveis do SDK/WDK no WinGet. Por exemplo, ao procurar todas as versões disponíveis do WDK, uma tabela como esta será mostrada:

Name                                        Id                              Version        Source
--------------------------------------------------------------------------------------------------
Windows Driver Kit - Windows 10.0.22621.2428 Microsoft.WindowsWDK.10.0.22621 10.1.22621.2428 winget
Windows Driver Kit - Windows 10.1.22000.1    Microsoft.WindowsWDK.10.0.22000 10.1.22000.1    winget
Windows Driver Kit                           Microsoft.WindowsWDK.10.0.19041 10.1.19041.685  winget
Windows Driver Kit - Windows 10.0.26100.1    Microsoft.WindowsWDK.10.0.26100 10.1.26100.1    winget

Em seguida, você pode instalar a combinação necessária de kits para um <kit-version> específico usando winget install:

SDK do Windows:

winget install --source winget --exact --id Microsoft.WindowsSDK.10.0.<kit-version>

WDK do Windows:

winget install --source winget --exact --id Microsoft.WindowsWDK.10.0.<kit-version>

Observação

Se a versão do Kit de Driver do Windows que você está procurando não estiver disponível no WinGet, você precisará baixá-la e instalá-la separadamente em Outros downloads do WDK.

A menos que você já tenha a extensão WDK Visual Studio de um WDK mais recente instalada, será necessário instalá-la manualmente. Ela está localizada por padrão em %ProgramFiles(x86)%\Windows Kits\10\Vsix\<vs-version>\10.0.<kit-version>.0\WDK.vsix para versões de kit 22621 e mais recentes, ou %ProgramFiles(x86)%\Windows Kits\10\Vsix\<vs-version>\WDK.vsix para versões de kit 22000 e mais antigas.

Localize primeiro a pasta do <vs-version> que você usará (VS2022 para versões 22621 e mais recentes, VS2019 para versões de 18362 a 22000). Se essa pasta contiver várias pastas versionadas, localize a pasta dentro com o número da versão mais recente. Anote esse local como <wdk-vsix-folder> se quiser instalar a extensão a partir da linha de comando.

Usar o Prompt de Comando:

for /f "usebackq tokens=*" %i in (`"%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere.exe" -nologo -latest -products * -property enginePath`) do (
  "%i\VSIXInstaller.exe" "<wdk-vsix-folder>\WDK.vsix"
)

Usar o PowerShell:

& $(& "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe" -nologo -latest -products * -property enginePath | Join-Path -ChildPath 'VSIXInstaller.exe') "<wdk-vsix-folder>\WDK.vsix"

Instalar um ambiente de desenvolvimento de driver completo usando um arquivo de configuração do WinGet

Ao usar um arquivo de configuração do WinGet, você pode configurar uma nova máquina para o desenvolvimento de driver com intervenção manual mínima.

Um arquivo de configuração para instalar o WDK do Windows 11, versão 24H2 e suas dependências é fornecido para sua conveniência. Essa configuração definirá os seguintes componentes:

  • Visual Studio 2022 Community.
  • O Visual Studio exigia fluxos de trabalho e componentes para o desenvolvimento de drivers.
  • SDK do Windows 11, versão 24H2.
  • WDK do Windows 11, versão 24H2.
  • Extensão do WDK Visual Studio.

Embora o uso de um arquivo de descrição de configuração funcione melhor para provisionar uma nova máquina, você pode usá-lo mesmo se já tiver alguns dos componentes instalados, e o WinGet tentará instalar apenas os componentes ausentes.

Dica

Você pode baixar e instalar diretamente o arquivo de configuração do WDK usando o PowerShell. Depois de instalar a versão mais recente do WinGet, você poderá executar os seguintes comandos:

# Open a new PowerShell terminal if needed
powershell

# Download configuration file to install WDK with VS 2022 Community
Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/microsoft/Windows-driver-samples/main/configuration.dsc.yaml' -OutFile configuration.dsc.yaml

# Install VS, SDK, WDK and WDK VS extension using the configuration file
winget configure -f configuration.dsc.yaml

Etapa 1: Configurar o WinGet

Verifique se você tem o WinGet versão 1.6 ou superior instalado na máquina que gostaria de provisionar. Você pode fazer isso executando winget --version em seu terminal e verificando se o número da versão de saída é v1.6.2631 ou maior. Caso contrário, ou se o terminal lançar um erro informando que o comando não existe, você precisará instalar a versão mais recente do WinGet antes de continuar.

Etapa 2: Baixar o arquivo de configuração do WDK

O arquivo de descrição da configuração pode ser baixado aqui. Salve este arquivo como configuration.dsc.yml e anote sua localização.

Dica

O arquivo de configuração fornecido instalará a edição Community do Visual Studio 2022. Se você precisar de outra edição, poderá editar Microsoft.VisualStudio.2022.Community e IDs de produtos Microsoft.VisualStudio.Product.Community com IDs diferentes para a edição que deseja instalar (para Professional: Microsoft.VisualStudio.2022.Professional e Microsoft.VisualStudio.Product.Professional; para Enterprise: Microsoft.VisualStudio.2022.Enterprise e Microsoft.VisualStudio.Product.Enterprise).

Etapa 3A: Executar a configuração do WinGet para instalar o arquivo de configuração do WDK

Em uma linha de comando no diretório onde o arquivo de configuração do WDK foi salvo, execute o seguinte comando para configurar sua máquina usando esse arquivo:

winget configure -f configuration.dsc.yaml

Etapa 3B: Usar o Dev Home para instalar o arquivo de configuração do WDK

Como alternativa, se você tiver o Dev Home instalado, poderá usá-lo para configurar sua máquina. Selecione "Configuração da máquina" na barra lateral e, em seguida, "Configurar o ambiente de desenvolvimento" > "Arquivo de configuração" na tela principal para abrir o arquivo de configuração do WDK que você baixou. Depois de confirmar que você gostaria de usar esse arquivo para configurar sua máquina, a instalação prosseguirá e, depois de concluída, você terá um ambiente pronto para o desenvolvimento do driver.

Confira também