Pular para o conteúdo principal
Um auxílio em tempo de desenvolvimento para determinados tipos de criação de perfil e prototipagem experimental.

Sintaxe

Parâmetros

Enable
Tipo: BOOL
Especifica um BOOL que ativa ou desativa o estado de energia estável.

Valor retornado

Tipo: HRESULT Este método retorna um dos Códigos de retorno do Direct3D 12.

Comentários

Este método só é útil durante o desenvolvimento de aplicativos. Ele permite que os desenvolvedores criem perfis do uso da GPU de vários algoritmos sem sofrer artefatos de dimensionamento dinâmico de frequência. Não chame este método na execução normal de um aplicativo lançado. Este método só funciona enquanto a máquina está no modo de desenvolvedor. Se o modo de desenvolvedor não estiver habilitado, ocorrerá a remoção do dispositivo. Em vez disso, chame este método em resposta a uma opção voltada para desenvolvedores, desativada por padrão. Chamá-lo em resposta a parâmetros de linha de comando, arquivos de configuração, chaves do Registro e comandos do console do desenvolvedor são cenários de uso razoáveis. Um estado de energia estável normalmente fixa as taxas de clock da GPU em uma configuração mais lenta, significativamente inferior à experimentada pelos usuários sob carga normal de aplicativo. Essa redução na taxa de clock afeta todo o sistema. Taxas de clock lentas são necessárias para garantir que os processadores não esgotem os limites de energia, corrente e temperatura. Cenários de uso normais costumam aproveitar a capacidade de um processador de fazer overclock dinamicamente. Quaisquer conclusões obtidas comparando dois designs sob um estado de energia estável devem ser verificadas novamente com resultados de apoio de cenários de uso reais.

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One

Confira também

ID3D12Device
Última modificação em 6 de outubro de 2026