Índice de tópicos sob NDA para desenvolvimento de console com o XBOX GDK

Todas as páginas deste índice exigem um NDA ativo do XBOX GDK for Console Development. Todas as páginas estão ocultas da navegação principal da barra lateral. As entradas abaixo são listadas apenas pelo título e não têm links; leitores autorizados por NDA podem acessá-las pelo GDKX.

Sobre esta seção

A guia Tópicos sob NDA reúne todas as páginas confidenciais de desenvolvimento de console com o XBOX GDK em uma única guia, para que autores e leitores com acesso por NDA possam ver todo o conteúdo rapidamente. As páginas são agrupadas em seções que espelham as guias em que os tópicos estão no restante da documentação:

Início — configuração do kit de desenvolvimento, configurações do kit de desenvolvimento e configuração para todo o estúdio.
Build — recursos do console (áudio, memória, armazenamento), recursos gráficos principais, princípios de jogos e engajamento com o ATG.
Ferramentas — PIX, compilador de sombreador, linha de comando, DevHome, hix e outras páginas de ferramentas de console.
Referências de API — cabeçalhos de referência da API de gráficos do GDK e grupos ocultos de APIs de sistema/ferramentas.

Início

Páginas confidenciais da guia Início da documentação: tudo o que é necessário para configurar, ativar e ajustar kits de desenvolvimento XBOX.

Configuração e instalação

Conceitos

Página	Descrição
Permissões de produto	Conceda a usuários, grupos e kits de desenvolvimento acesso a um produto por meio de áreas restritas do Partner Center.
Implantação	Tipos de implantação (Push, Run from PC, Streaming Install) e ferramentas (XBOX Manager, xbapp, Visual Studio).
Atualizações offline de emergência	Execute uma redefinição de fábrica EOU a partir de um USB quando um kit de desenvolvimento não inicializar.
Reinicializações inesperadas	Diagnostique por que um kit de desenvolvimento XBOX foi reiniciado ou desligado inesperadamente.
Mensagens de erro universais	Mensagens de erro universais (UEMs) comuns em kits de desenvolvimento XBOX e como resolver cada uma.
Remover o compartilhamento Gold	Redefina os privilégios do console para remover o compartilhamento Gold de um kit de desenvolvimento.
Dicas do XBOX One X Dev Kit	Dicas de ferramentas, atualizações, scripts e painel frontal para XBOX One X Dev Kits.
Modos de console	Aproxime outras plataformas XBOX por meio da troca de modo de console.

Configurações do kit de desenvolvimento

Página	Descrição
Modo de varejo ↔ Modo de desenvolvedor	Alterne um kit de desenvolvimento XBOX entre o Modo de varejo e o Modo de desenvolvedor.
Definir configurações	Modo de criação de perfil, ID da área restrita e tempos limite de ociosidade por meio do DevHome, do xbconfig ou do XBOX Manager.
Recuperação do SO por flash	Inscreva-se para atualizações automáticas de recuperação do SO ou aplique manualmente uma imagem de recuperação.
Definir um nome de host	Dê a um kit de desenvolvimento um nome de host amigável para que as ferramentas continuem funcionando após alterações de IP.

Configuração para todo o estúdio

Página	Descrição
Recuperar vários consoles	Execute recuperações paralelas do SO em vários kits de desenvolvimento a partir de um PC.
Atualizações automáticas de recuperação	Como funcionam as atualizações automáticas de recuperação do SO e como alterar a política de atualização.
Script de configuração autônoma	Crie scripts de configuração autônoma para OOBE, configuração a cada inicialização ou execuções ad hoc.

Build

Páginas confidenciais da guia Build da documentação: recursos do console, recursos gráficos principais, princípios de jogos e listas de verificação de engajamento com a Microsoft.

Recursos do console

Páginas ocultas sob NDA que ficam dentro de grupos do Build que, de outra forma, são públicos. Cada linha indica o ponto de entrada do grupo; as páginas individuais sob NDA dentro dele podem ser acessadas a partir dessa página inicial ou por link direto.

Grupo	Descrição	Página de entrada
Áudio	Visão geral do XAudio2 e diretrizes de áudio relacionadas para o XBOX GDK.	Visão geral do XAudio2
Memória	Uso de memória do kernel e do sistema, alocador de memória virtual, mapeamentos de arquivos graváveis e portabilidade/diagnóstico para consoles XBOX.	Visão geral da memória do sistema
Armazenamento — DirectStorage	Diretrizes confidenciais do DirectStorage: compactação, embaralhamentos e o white paper.	Visão geral do DirectStorage

Recursos principais

Gráficos

A maior parte da árvore Recursos principais → Gráficos é protegida por NDA. Cada linha é um subgrupo oculto ou um conjunto de páginas ocultas de nível superior em build/core-features/graphics/.

Grupo	Descrição	Página de entrada
D3D12X	Visão geral do XBOX Direct3D 12 (D3D12X), diferenças em relação ao PC, ATOC e tipos de objeto XMemAlloc.	Visão geral do D3D12X
DirectX (específico do console)	Tópicos do DirectX exclusivos do console: compactação de cor e profundidade, sinalizadores de criação, agendamento de quadros, sobreposições de hardware, gerenciamento de recursos nativos, tesselação fora do chip, suspensão e retomada.	Compactação de cor e profundidade
Visões gerais de gráficos	Páginas confidenciais de visão geral de gráficos (visão geral da GPU, barreiras aprimoradas, sincronização de GPU no Scarlett, suporte a HDR, 120 Hz, decodificação de CMask, áreas de tela).	Visão geral da GPU
Apresentações de gráficos — XDD 2024	Análises aprofundadas de gráficos do XDD 2024.	Apresentações
Apresentações de gráficos — XFEST 2019	Apresentações de gráficos do XFEST 2019.	Apresentações
Apresentações de gráficos — XFEST 2022	Apresentações de gráficos do XFEST 2022.	Apresentações
Novos recursos — Sombreadores de malha	Design da API de sombreadores de malha, descarte e renderização de meshlets, suporte ao Scarlett, uso e justificativa.	Visão geral dos sombreadores de malha
Novos recursos — Traçado de raios	Visão geral do XDXR, construtores de BVH, compactação, design de hardware, KDOP, RT PSO offline, autônomo, práticas recomendadas.	Visão geral do traçado de raios
Novos recursos — Sampler Feedback / SFS	API e design de GPU do Sampler Feedback Streaming, visão geral, uso e justificativa.	Visão geral do SFS
Novos recursos — VRS	API, recurso, visão geral e justificativa do Variable Rate Shading.	Visão geral do VRS
Novos recursos — XBTC	XBOX Texture Compressor, formato de arquivo, configuração em lote JSON e uso.	XBOX Texture Compressor
White papers	White papers confidenciais de gráficos (renderização em tabuleiro de xadrez, caches e coerência, instruções VMEM, otimizações para o Series S, resolução dinâmica, gerenciador de ESRAM, unidades de computação da GPU, acesso à memória da GPU, referência rápida de ocupação, visão geral da GPU).	Visão geral da GPU do XBOX One
Gráficos — nível superior	Diversas páginas ocultas de gráficos de nível superior: Dolby Vision, processamento de imagens, layouts de textura do Scarlett, visão geral da memória gráfica, visão geral de PSO de gráficos e o sumário graphics-newfeatures.	Visão geral da memória gráfica

Princípios de jogos

Sustentabilidade

Página	Descrição
Visão geral da sustentabilidade	Visão geral confidencial das diretrizes de sustentabilidade do XBOX para títulos do GDK.

Segurança

Página	Descrição
Visão geral da segurança de comunicação	Requisitos de confidencialidade, integridade e autenticação para comunicação de rede.
Conceitos de segurança de jogos	Visão geral dos conceitos de segurança e das categorias de ataque comuns.
Segurança de ferramentas de desenvolvimento	Diretrizes de segurança para ferramentas personalizadas de desenvolvimento de jogos.
Segurança geral de jogos	Segurança no nível do design: proteção de PII e testes de segurança.
Comunicação segura de jogos	Abordagem segura recomendada por tipo de tráfego em títulos do GDK.
Malha de jogo segura	Diretrizes de comunicação segura ponto a ponto e cliente/servidor.
Exemplos de comunicação segura	Exemplos do GDK e do XBOX services para comunicação segura.
Solicitações da Web seguras	APIs recomendadas, autenticação e TLS para HTTPS e WebSockets.

Engajamento com o ATG

Página	Descrição
Engajamento com o ATG	Envolva o Advanced Technology Group da Microsoft para obter suporte à plataforma.
Engajamento de gráficos	Lista de verificação para envolver o ATG em problemas de desempenho da GPU.
Engajamento de sistemas	Lista de verificação para envolver o ATG em questões de CPU, sistemas, memória e carregamento.

Otimizar

Páginas confidenciais da guia Otimizar da documentação: páginas ocultas de ferramentas de console que ficam dentro do grupo Ferramentas, que de outra forma é público. Cada linha indica o ponto de entrada do grupo; as páginas ocultas individuais dentro dele podem ser acessadas a partir da página de entrada ou por link direto.

Ferramentas (console)

Grupo	Descrição	Página de entrada
PIX	O conjunto de ferramentas PIX para XBOX: interface do usuário e fluxos de trabalho de nível superior, além dos subgrupos de GPU, GPU Trace, extensibilidade e explorador de sombreadores.	PIX
Ferramentas de linha de comando	Ferramentas de linha de comando confidenciais: `xbconfig`, `xbperf`, `xbttd` e utilitários relacionados.	xbconfig
DevHome	Páginas confidenciais do DevHome (exibição de desempenho).	Desempenho do DevHome
hix	A ferramenta de inspeção de sombreadores `hix` e seus fluxos de trabalho de depuração em tempo real.	hix
Compilador de sombreador (DXC)	Uso, extensões, intrínsecos e definições do XBOX DXC, portabilidade do FXC e visão geral do compilador de sombreador.	Compilador de sombreador
titleperfoverlay	A sobreposição de desempenho na tela `titleperfoverlay`.	titleperfoverlay
xhit	A ferramenta de instruções de hardware `xhit`.	Ferramenta xhit

Referências de API

Páginas confidenciais da guia Referências de API da documentação: cabeçalhos ocultos de referência da API de gráficos do GDK, além de grupos ocultos de APIs de sistema e ferramentas. Todos os grupos e páginas desta seção estão ocultos da barra lateral. A página de membros de cada cabeçalho é o ponto de entrada para suas interfaces, structs, enumerações e funções.

Gráficos

Grupo	Descrição	Página de entrada
Sumário da referência de gráficos	Sumário da referência confidencial da API de gráficos do GDK.	Sumário da referência de gráficos

APIs de gráficos

Cabeçalho	Descrição	Página de membros
d3d12_x	Direct3D 12 para a família XBOX One: interfaces, structs, enumerações e funções.	Membros de d3d12_x
d3d12shader_x	Interfaces de reflexão de sombreador para o D3D12 do XBOX.	Membros de d3d12shader_x
d3d12video_x	Decodificação, codificação e processamento de vídeo por hardware.	Membros de d3d12video_x
d3dx12_x	Biblioteca auxiliar do D3D12 somente de cabeçalho para a família XBOX One.	Membros de d3dx12_x
d3dx12_xs	Biblioteca auxiliar do D3D12 somente de cabeçalho para a família XBOX Series.	Membros de d3dx12_xs
Referência do XG	Biblioteca gráfica auxiliar: layouts de recursos, blocos e metadados de mip.	Membros do XG
Referência do XGMemory	Mapeamento dinâmico de ESRAM/memória do sistema na família XBOX One.	Membros do XGMemory
XBTC	Compactação de blocos BC1–BC7 offline para o pipeline do GDK.	Membros do XBTC
xg_xs	Variante para XBOX Series da biblioteca gráfica auxiliar XG.	Membros de xg_xs
DXCApi	API do DirectX Shader Compiler: compile HLSL para DXIL.	Membros da DXCApi

APIs de sistema

Grupo	Descrição	Página de entrada
XMem	Referência confidencial do XMem: página de membros, além de enumerações, funções, macros e structs.	Membros do XMem

APIs de ferramentas

Grupo	Descrição	Página de entrada
PIX3	Páginas confidenciais do PIX3 (capturas de GPU, função e struct de métricas de energia).	Capturas de GPU do PIX3

​Sobre esta seção

​Início

​Configuração e instalação

​Conceitos

​Configurações do kit de desenvolvimento

​Configuração para todo o estúdio

​Build

​Recursos do console

​Recursos principais

​Gráficos

​Princípios de jogos

​Sustentabilidade

​Segurança

​Engajamento com o ATG

​Otimizar

​Ferramentas (console)

​Referências de API

​Gráficos

​APIs de gráficos

​APIs de sistema

​APIs de ferramentas

Sobre esta seção

Início

Configuração e instalação

Conceitos

Configurações do kit de desenvolvimento

Configuração para todo o estúdio

Build

Recursos do console

Recursos principais

Gráficos

Princípios de jogos

Sustentabilidade

Segurança

Engajamento com o ATG

Otimizar

Ferramentas (console)

Referências de API

Gráficos

APIs de gráficos

APIs de sistema

APIs de ferramentas