Compartilhar via

D3D10_CREATE_DEVICE_FLAG enumeração (d3d10.h)

  • Artigo

Sinalizadores de criação de dispositivo.

Syntax

typedef enum D3D10_CREATE_DEVICE_FLAG {
  D3D10_CREATE_DEVICE_SINGLETHREADED = 0x1,
  D3D10_CREATE_DEVICE_DEBUG = 0x2,
  D3D10_CREATE_DEVICE_SWITCH_TO_REF = 0x4,
  D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONS = 0x8,
  D3D10_CREATE_DEVICE_ALLOW_NULL_FROM_MAP = 0x10,
  D3D10_CREATE_DEVICE_BGRA_SUPPORT = 0x20,
  D3D10_CREATE_DEVICE_PREVENT_ALTERING_LAYER_SETTINGS_FROM_REGISTRY = 0x80,
  D3D10_CREATE_DEVICE_STRICT_VALIDATION = 0x200,
  D3D10_CREATE_DEVICE_DEBUGGABLE = 0x400
} ;

Constantes

 
D3D10_CREATE_DEVICE_SINGLETHREADED
Valor: 0x1
Use esse sinalizador se um aplicativo chamar apenas D3D10 de um único thread. Se esse sinalizador não for especificado, o comportamento padrão de D3D10
é inserir um bloqueio durante cada chamada à API para evitar que vários threads alterem o estado interno. Usando esse sinalizador, nenhum bloqueio será feito, o que pode
aumentar ligeiramente o desempenho, mas poderá resultar em um comportamento indefinido se D3D10 for chamado de vários threads.
D3D10_CREATE_DEVICE_DEBUG
Valor: 0x2
Crie um dispositivo que dê suporte à camada de depuração.
D3D10_CREATE_DEVICE_SWITCH_TO_REF
Valor: 0x4
Crie simultaneamente uma versão de software (REF) e hardware (HAL) do dispositivo, o que permite que um aplicativo mude para um
dispositivo de referência para habilitar a depuração. Consulte Interface ID3D10SwitchToRef para obter mais informações.
D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONS
Valor: 0x8
Impede que vários threads sejam criados. Quando esse sinalizador é usado com um dispositivo WARP, nenhum thread adicional será criado por WARP e todos
A rasterização ocorrerá no thread de chamada. Esse sinalizador não é recomendado para uso geral. Consulte Observações.
D3D10_CREATE_DEVICE_ALLOW_NULL_FROM_MAP
Valor: 0x10
Retornar um ponteiro NULL em vez de disparar uma exceção no esgotamento de memória durante invocações para Map.
Sem esse sinalizador, uma exceção será gerada no esgotamento da memória. Válido somente no Windows 7.
D3D10_CREATE_DEVICE_BGRA_SUPPORT
Valor: 0x20
Faz com que a criação do dispositivo falhe se o suporte a BGRA não estiver disponível.

O suporte a BGRA habilita os seguintes formatos.


  • DXGI_FORMAT_B8G8R8A8_TYPELESS

  • DXGI_FORMAT_B8G8R8A8_UNORM

  • DXGI_FORMAT_B8G8R8A8_UNORM_SRGB

  • DXGI_FORMAT_B8G8R8X8_TYPELESS

  • DXGI_FORMAT_B8G8R8X8_UNORM

  • DXGI_FORMAT_B8G8R8X8_UNORM_SRGB


D3D10_CREATE_DEVICE_BGRA_SUPPORT só é relevante quando um dispositivo é criado com D3D10CreateDevice1
ou D3D10CreateDeviceAndSwapChain1 usando o D3D10_FEATURE_LEVEL_10_0 ou D3D10_FEATURE_LEVEL_10_1
níveis de recursos, o sinalizador será ignorado quando um dispositivo for criado com outros níveis de recursos.

Observe que o suporte a BGRA pode estar presente mesmo que o aplicativo não tenha especificado D3D10_CREATE_DEVICE_BGRA_SUPPORT.
O sinalizador apenas fará com que a criação do dispositivo falhe se o suporte a BGRA não estiver disponível.

D3D10_CREATE_DEVICE_BGRA_SUPPORT só é válido em sistemas Windows 7, Windows Server 2008 R2 e Windows Vista (KB971644) atualizados.
D3D10_CREATE_DEVICE_PREVENT_ALTERING_LAYER_SETTINGS_FROM_REGISTRY
Valor: 0x80
Faz com que o runtime do Direct3D ignore as configurações do Registro que ativam a camada de depuração. Você pode ativar a camada de depuração usando o Painel de Controle DirectX que foi incluído como parte do SDK do DirectX. Enviamos a última versão do SDK do DirectX em junho de 2010; você pode baixá-lo no Centro de Download da Microsoft. Você pode definir esse sinalizador em seu aplicativo, normalmente somente em builds de versão, para impedir que os usuários finais usem a Painel de Controle DirectX para monitorar como o aplicativo usa o Direct3D.

Nota Você também pode definir esse sinalizador em seu aplicativo para impedir que ferramentas de depuração do Direct3D, como Visual Studio Ultimate 2012, conectem seu aplicativo.

 

Windows 8.1: esse sinalizador não impede que Visual Studio 2013 e posterior em execução em Windows 8.1 e posteriores conectem seu aplicativo. Porém, esse sinalizador ainda impede que Visual Studio 2013 e posterior em execução em Windows 8 e anteriores conectem seu aplicativo.

Direct3D 11: Esse valor não tem suporte até Direct3D 11.1.
D3D10_CREATE_DEVICE_STRICT_VALIDATION
Valor: 0x200
Reservado. No momento, não há suporte para esse sinalizador. Não use.
D3D10_CREATE_DEVICE_DEBUGGABLE
Valor: 0x400
Faz com que o dispositivo e o driver mantenham as informações que você pode usar para depuração do sombreador. O impacto exato desse sinalizador varia de driver para driver. Para usar esse sinalizador, você deve ter D3D11_1SDKLayers.dll instalado; caso contrário, a criação do dispositivo falhará. O dispositivo criado dá suporte à camada de depuração. Para obter D3D11_1SDKLayers.dll, você deve instalar o SDK para Windows 8.

Direct3D 11: Esse valor não tem suporte até Direct3D 11.1.

Comentários

Os sinalizadores de criação de dispositivo são usados por D3D10CreateDevice e D3D10CreateDeviceAndSwapChain.

Um aplicativo pode criar (e destruir) threads dinamicamente para melhorar o desempenho especialmente em um computador com vários núcleos de CPU. No entanto, pode haver casos em que um aplicativo precisa impedir que threads extras sejam criados. Isso pode acontecer quando você deseja simplificar a depuração, o código do perfil ou desenvolver uma ferramenta, por exemplo. Para esses casos, use D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONS para solicitar que o driver de vídeo e o runtime não criem threads adicionais que possam interferir no aplicativo.

Requisitos

Requisito Valor
Cabeçalho d3d10.h

Confira também

Enumerações principais