Definições de pré-processador do GDK no XBOX - XBOX Game Development Documentation

Este artigo lista as definições de pré-processador específicas do Microsoft Game Development Kit (GDK) no XBOX.

Define de pré-processador	Descrição
_GAMING_XBOX	O define oficial para XBOX One ou XBOX Series X\|S. #ifdef _GAMING_XBOX // Microsoft Game Development Kit (GDK) on XBOX. …
_GAMING_XBOX_XBOXONE	O define indica a compilação com o GDK no XBOX One.
_GAMING_XBOX_SCARLETT	O define indica a compilação com o GDK no XBOX Series X\|S.
_GAMING_DESKTOP	O define indica a compilação no PC com o GDK.
_M_X64, _M_IX86, _M_ARM64, and _M_ARM	Ao escrever código específico da arquitetura do processador, e não da plataforma, use esses defines. Para o XBOX 360, o define equivalente é _M_PPCBE. _M_AMD64 é um alias de _M_X64 e era o nome original. Ele está sendo descontinuado em favor de _M_X64. Não use os defines herdados do Windows, como X86 e AMD64.
WINAPI_FAMILY	Os cabeçalhos da plataforma Microsoft fazem uso extensivo das macros de família e de partição do Windows definidas em winapifamily.h. Lembre-se de que as partições podem mudar (e de fato mudam entre o Windows 8.0 SDK e o Windows 8.1 SDK). Também são adicionados novos valores de PARTITION e FAMILY ao longo do tempo. O código cliente nunca deve usar diretamente os valores de PARTITION, a macro WINAPI_FAMILY_PARTITION nem a macro WINAPI_FAMILY_ONE_PARTITION. É razoável que o código cliente procure valores específicos de WINAPI_FAMILY. A versão do winapifamily.h do Windows 8.1 SDK tem um bloco de comentários ampliado que aborda esse uso.

Use as definições de pré-processador a seguir para código do Microsoft Game Development Kit (GDK) no XBOX.

#ifdef _GAMING_XBOX
// GDK on Xbox

#ifdef _GAMING_XBOX_SCARLETT
// Xbox Series X|S hardware
#elif _GAMING_XBOX_ONE
// Xbox One hardware

Quando você compila usando o Microsoft Game Development Kit (GDK), as regras do Microsoft Build do ambiente de desenvolvimento integrado (IDE) do Visual Studio definem automaticamente _GAMING_XBOX e WINAPI_FAMILY=WINAPI_FAMILY_GAMES. Os desenvolvedores que não usam o IDE do Visual Studio para compilar com o Microsoft Game Development Kit (GDK) precisam fornecer esses valores na linha de comando do compilador.

Gaming.Xbox.XboxOne.x64

/D_GAMING_XBOX /D_GAMING_XBOX_XBOXONE /DWINAPI_FAMILY=WINAPI_FAMILY_GAMES

Gaming.Xbox.Scarlett.x64

/D_GAMING_XBOX /D_GAMING_XBOX_SCARLETT /DWINAPI_FAMILY=WINAPI_FAMILY_GAMES

Gaming.Desktop.x64

/D_GAMING_DESKTOP /DWINAPI_FAMILY=WINAPI_FAMILY_DESKTOP_APP

Esses defines também se aplicam às plataformas x64 ‘clássicas’ quando você usa o Microsoft Game Development Kit.

Ao escrever código multiplataforma da Microsoft, você pode usar a construção a seguir.

    #if !defined(WINAPI_FAMILY) || (WINAPI_FAMILY == WINAPI_FAMILY_DESKTOP_APP)
    // This code is for Win32 desktop apps.
    #elif WINAPI_FAMILY == WINAPI_FAMILY_GAMES
    // This code is for the Microsoft Game Development Kit (GDK) (could also use _GAMING_XBOX if only targeting Xbox).
    #elif WINAPI_FAMILY == WINAPI_FAMILY_PHONE_APP
    // This code is for Windows phone 8.x.
    #elif WINAPI_FAMILY == WINAPI_FAMILY_APP
    // This code is for Microsoft Store apps for 8.x.
    #elif WINAPI_FAMILY == WINAPI_FAMILY_TV_TITLE
    // This code is for Xbox One Game OS/XDK.
    #elif WINAPI_FAMILY == WINAPI_FAMILY_TV_APP
    // This code is for Xbox One System OS/ADK.
    #else
    #error Unknown WINAPI_FAMILY value
    #endif  

​Gaming.Xbox.XboxOne.x64

​Gaming.Xbox.Scarlett.x64

​Gaming.Desktop.x64

Gaming.Xbox.XboxOne.x64

Gaming.Xbox.Scarlett.x64

Gaming.Desktop.x64