Onde está o SDK do DirectX?

A partir do Windows 8, o SDK do DirectX está incluído como parte do SDK do Windows.

Criamos originalmente o SDK do DirectX como uma plataforma de alto desempenho para desenvolvimento de jogos no Windows. À medida que as tecnologias DirectX amadureceram, tornaram-se relevantes para uma gama mais ampla de aplicações. Hoje, a disponibilidade de hardware Direct3D em computadores leva até mesmo aplicativos de desktop tradicionais a usar aceleração de hardware gráfico. Em paralelo, as tecnologias DirectX estão mais integradas com o Windows. O DirectX é agora uma parte fundamental do Windows.

Como o SDK do Windows é o SDK do desenvolvedor principal para Windows, o DirectX agora está incluído nele. Agora você pode usar o SDK do Windows para criar ótimos jogos para Windows. Para baixar o SDK do Windows 11, o SDK do Windows 10 ou o SDK do Windows 8.x, consulte Arquivo do SDK do Windows e do emulador.

As seguintes tecnologias e ferramentas, anteriormente parte do SDK do DirectX, agora fazem parte do SDK do Windows.

O SDK legado do DirectX está disponível para download no Centro de Download da Microsoft se necessário, mas o uso para novos projetos não é recomendado.

Usando projetos SDK do DirectX com o Visual Studio

Os exemplos do SDK do DirectX de junho de 2010 são suportados com SKUs premium do Visual Studio (Microsoft Visual Studio Professional 2012, Microsoft Visual Studio Ultimate 2012, Microsoft Visual Studio Professional 2013 ou Microsoft Visual Studio Ultimate 2013) no Windows 7 e no Windows 8 e versões posteriores. Devido à transição dos cabeçalhos e bibliotecas do DirectX para o SDK do Windows, são necessárias alterações nas configurações do projeto para compilar corretamente estes exemplos, dado o modo como o SDK do Windows 8 e posteriores é distribuído nas versões premium do Visual Studio.

Estas etapas também se aplicam aos seus próprios projetos que dependem do SDK do DirectX.

1. Verifique se a versão de junho de 2010 do SDK do DirectX está instalada no computador de desenvolvimento. Se instalar num computador que executa o Windows 8 ou versão posterior, será solicitado a habilitar o .NET 3.5 como pré-requisito do SDK do DirectX.

   Observação

   O SDK do DirectX falha ao instalar se você tiver uma determinada versão do pacote redistribuível do Visual C++ 2010 já instalada. Para obter mais informações e uma solução para corrigir esse problema, consulte erro "S1023" ao instalar o SDK do DirectX (junho de 2010).

    

2. Certifique-se de que você está usando um dos SKUs premium do Visual Studio. O Microsoft Visual Studio Express 2012 para Windows 8 ou o Microsoft Visual Studio Express 2013 para Windows não criará o Windows 8 e aplicativos de área de trabalho posteriores, como os exemplos do SDK do DirectX. Para instalar um dos SKUs premium do Visual Studio, vá para a página de downloads do Visual Studio: e siga as instruções.

3. Use o Navegador de Exemplo do SDK do DirectX para instalar os arquivos de projeto para o exemplo desejado. Abra o ficheiro de solução compatível com o Microsoft Visual Studio 2010 do exemplo (sufixado com _2010).

4. Se você estiver abrindo o exemplo em um sistema que só tem o Microsoft Visual Studio 2012 ou Microsoft Visual Studio 2013 instalado, você receberá a seguinte mensagem: "Esta solução contém um ou mais projetos usando uma versão anterior do compilador VC++ e bibliotecas. Cada projeto pode ser atualizado para usar o compilador VC++ e bibliotecas (v110)." Escolha a opção Update nesta caixa de diálogo para atualizar antes de abrir o projeto.

   Caso contrário, você pode atualizar para o compilador e bibliotecas do Visual Studio 2012 ou Visual Studio 2013 C++ 11 depois que eles forem carregados, clicando com o botão direito do mouse na solução e escolhendo Atualizar projetos VC++.

5. O D3DX não é considerado a API canônica para usar o Direct3D no Windows 8 e posterior e, portanto, não está incluído no SDK do Windows correspondente. Investigue soluções alternativas para trabalhar com a API do Direct3D. Para projetos herdados, como os exemplos do SDK do DirectX do Windows 7 (e anteriores), as etapas a seguir são necessárias para criar aplicativos com o D3DX usando o SDK do DirectX:

   1. Modifique os diretórios VC++ do projeto da seguinte forma para usar a ordem correta para cabeçalhos e bibliotecas SDK.

      i. Abra **Propriedades** para o projeto e selecione a página **Diretórios VC++**. II. Selecione **Todas as configurações e todas as plataformas**. iii. Defina esses diretórios da seguinte maneira:

      • Diretórios executáveis: <herda dos padrões pai ou do projeto> (no menu suspenso do lado direito)
      • Incluir Diretórios: $(IncludePath);$(DXSDK_DIR)Include
      • Incluir diretórios de biblioteca: $(LibraryPath);$(DXSDK_DIR)Lib\x86

      iv. Clique Aplicar.
      v. Escolha a plataforma x64 .
      vi. Defina o Diretório de Biblioteca da seguinte maneira:

      • Diretórios de biblioteca: $(LibraryPath);$(DXSDK_DIR)Lib\x64

   2. Sempre que "d3dx9.h", "d3dx10.h" ou "d3dx11.h" estiverem incluídos no seu projeto, certifique-se de incluir explicitamente "d3d9.h", "d3d10.h" e "dxgi.h", ou "d3d11.h" e "dxgi.h" primeiro para garantir que você está pegando a versão mais recente. Você pode desativar aviso C4005 se necessário; No entanto, esse aviso indica que você está usando a versão mais antiga desses cabeçalhos.

   3. Remova todas as referências a DXGIType.h em seu projeto. Esse cabeçalho não existe no SDK do Windows e a versão do SDK do DirectX entra em conflito com o novo winerror.h.

   4. Todas as DLLs D3DX são instaladas no computador de desenvolvimento pela instalação do SDK do DirectX. Certifique-se de que as dependências D3DX necessárias sejam redistribuídas com qualquer amostra ou com seu aplicativo se ele for movido para outra máquina.

   5. Lembre-se de que as tecnologias de substituição para usos atuais do D3DX11 incluem DirectXTex, DirectXTK, DirectXMeshe UVAtlas. D3DXMath é substituído por DirectXMath.

6. Certifique-se de que você está usando a nova versão do compilador de sombreador HLSL, observando as seguintes condições:

   1. Alterar o diretório executável de acordo com a etapa 5 fará com que as compilações de projeto usem FXC a partir da instalação do SDK do Windows. Lembre-se de que os arquivos HLSL agora são oficialmente reconhecidos pelo Visual Studio. Você pode adicioná-los como arquivos de projeto e definir opções do compilador através do sistema de projeto.

   2. Invocar a compilação em tempo de execução através da DLL D3DX herdada usará a versão incorreta mais antiga do compilador HLSL. Substitua todas as referências às APIs D3DXCompile*, D3DX10Compile* e D3DX11Compile* em seu código pela função D3DCompile em D3DCOMPILER_46.DLL ou D3DCOMPILER_47.DLL.

   3. Qualquer projeto que usa compilação de sombreador em tempo de execução deve ter D3DCOMPILER_xx.DLL copiado para o caminho executável local para o projeto. Esta DLL está disponível neste subdiretório da instalação do SDK do Windows em %ProgramFiles(x86)%\Windows Kits\8.0\Redist\D3D\<arch> ou %ProgramFiles(x86)%\Windows Kits\8.1\Redist\D3D\<arch> onde <arch> é x86 e x64.

      O D3DCOMPILER_46.DLL ou D3DCOMPILER_47.DLL do SDK do Windows não é um componente do sistema e não deve ser copiado para o diretório do sistema Windows. Você pode redistribuir esta DLL para outros computadores com a sua aplicação como uma DLL em modo de coexistência.

7. Qualquer projeto que use a API XInput e se destine a ser executado no Windows 7 ou em versões mais antigas do Windows precisa usar a versão herdada (9.1.0) ou precisará incluir explicitamente os cabeçalhos e bibliotecas para esse componente do SDK do DirectX. O cabeçalho XInput e XINPUT. LIB que estão incluídos no SDK do Windows destinam-se apenas à versão (1.4) fornecida como parte do Windows 8 e posterior. O mesmo cabeçalho pode ser usado com o XINPUT9_1_0.LIB para usar a versão herdada, que está incluída nas versões mais antigas do Windows. A versão herdada do XInput não deteta todos os recursos ou suporta áudio integrado ao controlador, portanto, se o suporte para esses recursos for necessário, você deverá usar a versão do SDK do DirectX (1.3).

   Para usar a API XInput de nível inferior com todos os recursos, você deve #include os cabeçalhos XInput específicos do SDK do DirectX diretamente:

   #include <%DXSDK_DIR%Include\xinput.h>

   ... e nas opções do vinculador para Dependências Adicionais, vincule-se diretamente à biblioteca DirectX SDK XInput:

   %DXSDK_DIR%Include\<arch>\xinput.lib

   O binário XINPUT1_3.DLL é instalado nos diretórios do sistema Windows pela instalação do SDK do DirectX no computador de desenvolvimento. Você precisará distribuir este binário com o seu aplicativo usando a instalação do DirectX Setup a partir do DirectX SDK.

8. Qualquer projeto que use a API XAudio2 e se destine a ser executado no Windows 7 ou em versões mais antigas do Windows precisa usar a versão mais antiga (9.1.0) ou incluir explicitamente os cabeçalhos e bibliotecas para esse componente do SDK do DirectX. Os cabeçalhos XAudio2 e bibliotecas incluídas no SDK do Windows destinam-se apenas à versão (2.8) incluída como parte do Windows 8.

   Por exemplo, com XAudio2, você deve #include os cabeçalhos XAudio2 específicos do SDK do DirectX diretamente:

   #include <%DXSDK_DIR%Include\xaudio2.h>

   ... e nas opções do vinculador para Dependências Adicionais, vincule-se diretamente à biblioteca XAudio2 do SDK do DirectX:

   %DXSDK_DIR%Include\<arch>\xaudio2.lib

   O binário XAUDIO2_7.DLL é instalado nos diretórios do sistema Windows pela instalação do SDK do DirectX no computador de desenvolvimento. Você precisa redistribuir essas bibliotecas com seu aplicativo usando a instalação do DirectX Setup do SDK do DirectX.

9. Se você usou o SDK do DirectX com versões anteriores do Visual Studio, a atualização do Visual Studio 2010 pode ter migrado o caminho do SDK do DirectX para as configurações padrão do projeto. É recomendável remover essas configurações para evitar erros de compilação futuros. No diretório %USERPROFILE%\AppData\Local\Microsoft\MSBuild\v4.0, modifique os ficheiros Microsoft.Cpp.Win32.user e Microsoft.Cpp.x64.user para remover todas as referências aos caminhos DXSDK_DIR. Como alternativa, você pode remover todo o nó> PropertyGroup do <que contém as entradas Path, como <> ExecutablePath e <> IncludePath, para reverter para os padrões padrão. Se você não vir referências a DXSDK_DIR nesses arquivos, nenhuma alteração será necessária.

10. Se o aplicativo resultante oferecer suporte ao Windows Vista com Service Pack 2 (SP2), bem como ao Windows 7 e Windows 8 e posterior, defina a Definição de Pré-processador chamada _WIN32_WINNT como 0x600. Se suportar apenas o Windows 7, o Windows 8 e versões posteriores, defina como 0x601.

    Por exemplo:

    1. Abra Propriedades do projeto e selecione C/C++>Pré-processador.
    2. Selecione Todas as configurações e Todas as plataformas.
    3. Vá para a seção Definições de pré-processador e defina _WIN32_WINNT=0x600.
    4. Clique Aplicar.

Tópicos relacionados

Games for Windows e o SDK do DirectX

Onde está o SDK do DirectX (Edição 2021)?

SDKs DirectX de uma determinada época

Viver sem D3DX