> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Índice de tópicos de desenvolvimento de console com o XBOX GDK protegidos por NDA, reunidos em uma única guia para que autores e leitores autorizados por NDA os acessem pelo portal do GDKX.

<Note>
  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.
</Note>

## 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 |


## Related topics

- [XBOX Tools Framework](/pt-BR/reference/tools/xtf/atoc-xbox-tools-framework.md)
- [Ambiente e ferramentas de desenvolvimento de jogos para PC](/pt-BR/tools/tools-pc/gc-tools-pc-toc.md)
- [XtfCreateConsoleManager](/pt-BR/reference/tools/xtf/xtfconsolemanager/methods/xtfcreateconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [Método IXtfConsoleManager::GetDefaultConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [Ferramentas de linha de comando para o desenvolvimento para PC](/pt-BR/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)