For games targeting PC Desktop using the Gaming Runtime, you are free to use Direct3D 12, Direct3D 11, or even legacy Direct3D 9. Note there are some special considerations if making use of legacy DirectX SDK components such as D3DX9, D3DX10, D3DX11, etc. See the DirectX Framework package documentation for more details.
Getting started by using Visual Studio project templates for the Gaming Runtime
When the Microsoft Game Development Kit (GDK) is installed on a development PC with Visual Studio, it installs five project templates for targeting PC Desktop as shown in the following table.
To access these templates:
- Open Visual Studio.
- Select File > New > Project. The New Project dialog box appears.
- In the New Project dialog, set the All Languages filter to C++, set the All Platforms filter to Windows, and set All Project Types to Games. You can search for the project names above as well.
- From the list of Microsoft Game Development Kit project templates, select the project template that you want.
- Select OK.
Use the appropriate template
Game exclusively targeting PC Desktop
If you’re developing a game that exclusively targets PC devices, the Direct3D 12 Desktop Game template is the common starting point. Some of the key aspects of this template include the following:- Uses Windows API Family
WINAPI_FAMILY_DESKTOP_APPand links against typical PC Desktop libraries, including kernel32.lib, user32.lib, etc. As a result, the full breadth of PC Desktop APIs are available for use in the game. - Includes the necessary headers and libraries so that the template is ready for the addition of the Direct3D 12 graphics implementation that’s compatible with PC Desktop. The template provides a simple swapchain, Direct3D device, and basic game update & render loop.
- Links against XGameRuntime.lib and includes the necessary headers so that all of the Gaming Runtime capabilities are ready for use.
- The XBOX Live API (XSAPI) extension library is also available by default. Additional Microsoft Game Development Kit (GDK) extension libraries can be added as well.
- Declares a build configuration that’s based on either the ‘stock’ x64 platform or the custom MSBuild platform Gaming.Desktop.x64, which builds an x64 target with the expectation that you’re iterating on the game locally (on your development PC) by using the local debugger.
- Creates a MicrosoftGameConfig.mgc file with placeholder information that you fill in with your title’s information from Partner Center.