D3D10_CREATE_DEVICE_FLAG enumeração (d3d10.h)

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