Skip to main content
Há algumas diferenças entre o Direct3D no XBOX One e no Windows com relação à seleção de runtime, aos recursos de troca, aos formatos de vídeo planares, à obtenção do estado de tela inteira, à linguagem de sombreador de alto nível (HLSL) e ao Windows Imaging Component (WIC).

Seleção de runtime

Para aplicativos de título do XBOX One, o adaptador Windows Advanced Rasterization Platform (WARP) não está disponível. ID3D12Debug::EnableDebugLayer pode ser usado para habilitar a validação de depuração no runtime, embora não por meio da disposição em camadas tradicional empregada no Windows. ID3D12Debug::SetProcessDebugFlags também pode ser usado para selecionar um runtime instrumentado que oferece suporte à criação de perfil do PIX e é executado com desempenho mais próximo ao da versão de varejo.

Recursos de troca

O XBOX One não oferece suporte a cadeias de troca, permitindo, em vez disso, a apresentação direta de objetos de recurso exibíveis. Cabe ao título criar e gerenciar seu próprio pool de recursos de troca. Para obter mais informações sobre as alterações na apresentação, consulte Apresentação e agendamento de quadros no XBOX One. Atualmente, os formatos compatíveis com recursos de troca estão listados a seguir. A diferença entre alguns formatos é simplesmente a ordem das cores.
  • DXGI_FORMAT_B8G8R8A8_UNORM
  • DXGI_FORMAT_R8G8B8A8_UNORM
  • DXGI_FORMAT_B8G8R8A8_UNORM_SRGB
  • DXGI_FORMAT_R8G8B8A8_UNORM_SRGB
  • DXGI_FORMAT_R10G10B10A2_UNORM

Formatos de vídeo planares

Os formatos de vídeo atualmente compatíveis com o XBOX One são NV12, P010, P016, 420_opaque e NV11. Para obter mais informações, consulte Enumeração DXGI_FORMAT.

Obtenção do estado de tela inteira

GetFullScreenState não pode ser chamado no XBOX One. Isso ocorre porque as cadeias de troca não podem ser criadas, e o método é destinado apenas a aplicativos DirectX da área de trabalho. Em vez disso, se você precisar saber quando seus primeiros gráficos são mostrados ao usuário, chame ID3D12Device::GetFrameStatisticsX com o tipo D3D12XBOX_FRAME_STATISTICS_TYPE_DISPLAY. Você deve presumir que a janela do jogo permanece no mesmo estado enquanto ela estiver no estado de execução do gerenciamento do tempo de vida do processo (PLM). Para obter mais informações, consulte:

Linguagem de sombreador de alto nível (HLSL)

A linguagem de sombreador de alto nível (HLSL) no XBOX One é uma implementação completa da Microsoft HLSL. A HLSL e o pipeline gráfico estão documentados no Microsoft Docs. No entanto, há vários pequenos erros de documentação:
  • GetRenderTargetSamplePosition é listado como retornando um UINT, mas esse método na verdade retorna um float2.
  • O tipo de retorno UINT não se aplica na linguagem de sombreador. O valor correto é uint em letras minúsculas ou escrito por extenso como unsigned int.

Windows Imaging Component (WIC)

O Windows Imaging Component (WIC) é uma plataforma extensível que fornece uma API de baixo nível para imagens digitais. O XBOX One oferece suporte ao WIC2. Para obter detalhes sobre os novos recursos do WIC2, consulte Novidades do WIC. Para obter detalhes sobre o formato WIC, consulte Windows Imaging Component ou o wiki do DirectXTex no GitHub. Há várias ressalvas quanto ao suporte ao WIC em títulos do XBOX One (Game OS).
  • Expressões de política de metadados de fotos não são compatíveis.
  • O codec HD Photo / JPEG-XR (identificado por GUID_ContainerFormatWmp e com as extensões de arquivo .jxr, .hdp e .wdp) não é compatível.
  • O codec BMP não oferece suporte a algumas variantes de formato mais antigas específicas do GDI.
  • Algumas conversões de formato de pixel não são compatíveis.
    • GUID_WICPixelFormat48bppRGBFixedPoint
    • GUID_WICPixelFormat48bppBGRFixedPoint
    • GUID_WICPixelFormat16bppGrayFixedPoint
    • GUID_WICPixelFormat96bppRGBFixedPoint
    • GUID_WICPixelFormat64bppRGBAFixedPoint
    • GUID_WICPixelFormat64bppBGRAFixedPoint
    • GUID_WICPixelFormat128bppRGBAFixedPoint
    • GUID_WICPixelFormat64bppRGBAHalf
    • GUID_WICPixelFormat48bppRGBHalf
    • GUID_WICPixelFormat32bppRGBE
    • GUID_WICPixelFormat16bppGrayHalf
    • GUID_WICPixelFormat32bppGrayFixedPoint
    • GUID_WICPixelFormat64bppRGBFixedPoint
    • GUID_WICPixelFormat128bppRGBFixedPoint
    • GUID_WICPixelFormat64bppRGBHalf
    • GUID_WICPixelFormat64bppPRGBAHalf
    • Todos os formatos CMYK e formatos nChannel
Consulte Windows Imaging Component (WIC) no XBOX para obter informações relacionadas.
Last modified on October 6, 2026