enumeración D3D10_CREATE_DEVICE_FLAG (d3d10.h)

  • Artículo

Marcas de creación de dispositivos.

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 esta marca si una aplicación solo llamará a D3D10 desde un único subproceso. Si no se especifica esta marca, el comportamiento predeterminado de D3D10
es especificar un bloqueo durante cada llamada API para evitar que varios subprocesos modifiquen el estado interno. Al usar esta marca, no se tomarán bloqueos que puedan
aumentar ligeramente el rendimiento, pero podría dar lugar a un comportamiento indefinido si se llama a D3D10 desde varios subprocesos.
D3D10_CREATE_DEVICE_DEBUG
Valor: 0x2
Cree un dispositivo que admita la capa de depuración.
D3D10_CREATE_DEVICE_SWITCH_TO_REF
Valor: 0x4
Cree una versión de software (REF) y hardware (HAL) del dispositivo simultáneamente, lo que permite que una aplicación cambie a un
dispositivo de referencia para habilitar la depuración. Vea ID3D10SwitchToRef Interface para obtener más información.
D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONS
Valor: 0x8
Impide que se creen varios subprocesos. Cuando se usa esta marca con un dispositivo WARP, no se creará ningún subproceso adicional por WARP y todos
La rasterización se producirá en el subproceso que llama. Esta marca no se recomienda para uso general. Vea Notas.
D3D10_CREATE_DEVICE_ALLOW_NULL_FROM_MAP
Valor: 0x10
Devuelve un puntero NULL en lugar de desencadenar una excepción en el agotamiento de memoria durante las invocaciones a Map.
Sin esta marca, se generará una excepción en el agotamiento de memoria. Solo es válido en Windows 7.
D3D10_CREATE_DEVICE_BGRA_SUPPORT
Valor: 0x20
Hace que se produzca un error en la creación de dispositivos si la compatibilidad con BGRA no está disponible.

La compatibilidad con BGRA habilita los siguientes 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 solo es relevante cuando se crea un dispositivo con D3D10CreateDevice1
o D3D10CreateDeviceAndSwapChain1 mediante el D3D10_FEATURE_LEVEL_10_0 o D3D10_FEATURE_LEVEL_10_1
Niveles de características, la marca se omitirá cuando se cree un dispositivo con otros niveles de características.

Tenga en cuenta que la compatibilidad con BGRA puede estar presente incluso si la aplicación no especificó D3D10_CREATE_DEVICE_BGRA_SUPPORT.
La marca simplemente hace que se produzca un error en la creación de dispositivos si la compatibilidad con BGRA no está disponible.

D3D10_CREATE_DEVICE_BGRA_SUPPORT solo es válido en los sistemas Windows 7, Windows Server 2008 R2 y Windows Vista (KB971644) actualizados.
D3D10_CREATE_DEVICE_PREVENT_ALTERING_LAYER_SETTINGS_FROM_REGISTRY
Valor: 0x80
Hace que el tiempo de ejecución de Direct3D omita la configuración del Registro que activa la capa de depuración. Puede activar la capa de depuración mediante el Panel de control de DirectX que se incluyó como parte del SDK de DirectX. Hemos enviado la última versión del SDK de DirectX en junio de 2010; puede descargarlo desde el Centro de descarga de Microsoft. Puedes establecer esta marca en la aplicación, normalmente solo en compilaciones de versión, para evitar que los usuarios finales usen directX Panel de control para supervisar cómo usa Direct3D la aplicación.

Nota También puedes establecer esta marca en la aplicación para evitar que las herramientas de depuración de Direct3D, como Visual Studio Ultimate 2012, enlacen la aplicación.

 

Windows 8.1: esta marca no impide que Visual Studio 2013 y versiones posteriores se ejecuten en Windows 8.1 y versiones posteriores para enlazar la aplicación. Sin embargo, esta marca impide que Visual Studio 2013 y versiones posteriores se ejecuten en Windows 8 y versiones anteriores para enlazar la aplicación.

Direct3D 11: Este valor no se admite hasta Direct3D 11.1.
D3D10_CREATE_DEVICE_STRICT_VALIDATION
Valor: 0x200
Reservado. Actualmente no se admite esta marca. No debe usarse.
D3D10_CREATE_DEVICE_DEBUGGABLE
Valor: 0x400
Hace que el dispositivo y el controlador conserven la información que puede usar para la depuración del sombreador. El impacto exacto de esta marca variará de controlador a controlador. Para usar esta marca, debe tener D3D11_1SDKLayers.dll instalado; de lo contrario, se produce un error en la creación del dispositivo. El dispositivo creado admite la capa de depuración. Para obtener D3D11_1SDKLayers.dll, debe instalar el SDK para Windows 8.

Direct3D 11: Este valor no se admite hasta Direct3D 11.1.

Comentarios

D3D10CreateDevice y D3D10CreateDevice y D3D10CreateDeviceAndSwapChain.

Una aplicación podría crear (y destruir) subprocesos de forma dinámica para mejorar el rendimiento especialmente en una máquina con varios núcleos de CPU. Sin embargo, puede haber casos en los que una aplicación necesite evitar que se creen subprocesos adicionales. Esto puede ocurrir cuando desea simplificar la depuración, el código de perfil o desarrollar una herramienta por ejemplo. En estos casos, use D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONS para solicitar que el runtime y el controlador de vídeo no creen ningún subproceso adicional que pueda interferir con la aplicación.

Requisitos

Requisito Valor
Header d3d10.h

Consulte también

Enumeraciones principales