XBOX용 GDK 전처리기 정의 - XBOX Game Development Documentation

이 문서에서는 XBOX용 Microsoft Game Development Kit (GDK)에 특화된 전처리기 정의를 나열합니다.

전처리기 정의	설명
_GAMING_XBOX	XBOX One 또는 XBOX Series X\|S를 위한 공식 정의입니다. #ifdef _GAMING_XBOX // Microsoft Game Development Kit (GDK) on Xbox. …
_GAMING_XBOX_XBOXONE	XBOX One의 GDK로 빌드하고 있음을 나타내는 정의입니다.
_GAMING_XBOX_SCARLETT	XBOX Series X\|S의 GDK로 빌드하고 있음을 나타내는 정의입니다.
_GAMING_DESKTOP	GDK를 사용하여 PC에서 빌드하고 있음을 나타내는 정의입니다.
_M_X64, _M_IX86, _M_ARM64, _M_ARM	플랫폼이 아닌 프로세서 아키텍처에 특화된 코드를 작성할 때 이 정의를 사용하세요. XBOX 360의 경우 동등한 정의는 _M_PPCBE입니다. _M_AMD64는 _M_X64의 별칭이며 원래 이름이었습니다. _M_X64로 대체되어 사용이 중단되고 있습니다. X86 및 AMD64 같은 Windows 레거시 정의는 사용하지 마세요.
WINAPI_FAMILY	Microsoft 플랫폼 헤더는 winapifamily.h에 정의된 Windows family 및 partition 매크로를 광범위하게 사용합니다. partition은 변경될 수 있으며(실제로 Windows 8.0 SDK와 Windows 8.1 SDK 사이에 변경됨) 시간이 지남에 따라 새로운 PARTITION 및 FAMILY 값이 추가된다는 점을 기억하세요. 클라이언트 코드는 PARTITION 값, WINAPI_FAMILY_PARTITION 매크로 또는 WINAPI_FAMILY_ONE_PARTITION 매크로를 직접 사용해서는 안 됩니다. 클라이언트 코드가 WINAPI_FAMILY의 특정 값을 확인하는 것은 합리적입니다. Windows 8.1 SDK 버전의 winapifamily.h에는 이 사용법을 다루는 확장된 주석 블록이 있습니다.

XBOX용 Microsoft Game Development Kit (GDK) 코드에는 다음 전처리기 정의를 사용하세요.

#ifdef _GAMING_XBOX
// GDK on Xbox

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

Microsoft Game Development Kit (GDK)를 사용하여 빌드할 때 Visual Studio 통합 개발 환경(IDE) Microsoft Build 규칙은 자동으로 _GAMING_XBOX와 WINAPI_FAMILY=WINAPI_FAMILY_GAMES를 정의합니다. Visual Studio IDE를 사용하지 않고 Microsoft Game Development Kit (GDK)에 대해 빌드하는 개발자는 컴파일러 명령줄에서 이러한 값을 제공해야 합니다.

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

이러한 정의는 Microsoft Game Development Kit을 사용할 때 ‘기존(classic)’ x64 플랫폼에도 적용됩니다.

Microsoft 크로스 플랫폼 코드를 작성할 때는 다음과 같은 구조를 사용할 수 있습니다.

    #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  

마지막 수정일 2026년 8월 24일

관련 항목

XBOX Series X|S 및 XBOX One용 Visual Studio 구성하기 Visual Studio (목차)GDK에서 Clang/LLVM 사용하기 PC 게임 개발을 위한 Visual Studio 프로젝트 템플릿 GameInput API 버전 관리

⌘I