Partager via

énumération D3D10_CREATE_DEVICE_FLAG (d3d10.h)

  • Article

Indicateurs de création d’appareil.

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
Valeur : 0x1
Utilisez cet indicateur si une application appelle D3D10 uniquement à partir d’un seul thread. Si cet indicateur n’est pas spécifié, le comportement par défaut de D3D10
consiste à entrer un verrou lors de chaque appel d’API pour empêcher plusieurs threads de modifier l’état interne. En utilisant cet indicateur, aucun verrou ne sera pris qui peut
augmente légèrement les performances, mais peut entraîner un comportement non défini si D3D10 est appelé à partir de plusieurs threads.
D3D10_CREATE_DEVICE_DEBUG
Valeur : 0x2
Créez un appareil qui prend en charge la couche de débogage.
D3D10_CREATE_DEVICE_SWITCH_TO_REF
Valeur : 0x4
Créer simultanément une version logicielle (REF) et une version matérielle (HAL) de l’appareil, ce qui permet à une application de basculer vers un
référencer l’appareil pour activer le débogage. Pour plus d’informations, consultez Interface ID3D10SwitchToRef .
D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONS
Valeur : 0x8
Empêche la création de plusieurs threads. Lorsque cet indicateur est utilisé avec un appareil WARP, aucun thread supplémentaire n’est créé par WARP et tous les threads
la rastérisation se produit sur le thread appelant. Cet indicateur n’est pas recommandé pour une utilisation générale. Consultez la section Remarques.
D3D10_CREATE_DEVICE_ALLOW_NULL_FROM_MAP
Valeur : 0x10
Retourne un pointeur NULL au lieu de déclencher une exception en cas d’épuisement de la mémoire pendant les appels à Mapper.
Sans cet indicateur, une exception est levée en cas d’épuisement de la mémoire. Valide uniquement sur Windows 7.
D3D10_CREATE_DEVICE_BGRA_SUPPORT
Valeur : 0x20
Entraîne l’échec de la création de l’appareil si la prise en charge de BGRA n’est pas disponible.

La prise en charge de BGRA active les formats suivants.


  • 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 est pertinent uniquement lorsqu’un appareil est créé avec D3D10CreateDevice1
ou D3D10CreateDeviceAndSwapChain1 à l’aide du D3D10_FEATURE_LEVEL_10_0 ou D3D10_FEATURE_LEVEL_10_1
niveaux de fonctionnalité , l’indicateur est ignoré lorsqu’un appareil est créé avec d’autres niveaux de fonctionnalité.

Notez que la prise en charge de BGRA peut être présente même si l’application n’a pas spécifié D3D10_CREATE_DEVICE_BGRA_SUPPORT.
L’indicateur entraîne simplement l’échec de la création de l’appareil si la prise en charge de BGRA n’est pas disponible.

D3D10_CREATE_DEVICE_BGRA_SUPPORT est uniquement valide sur les systèmes Windows 7, Windows Server 2008 R2 et Windows Vista (KB971644) mis à jour.
D3D10_CREATE_DEVICE_PREVENT_ALTERING_LAYER_SETTINGS_FROM_REGISTRY
Valeur : 0x80
Le runtime Direct3D ignore les paramètres du Registre qui activent la couche de débogage. Vous pouvez activer la couche de débogage à l’aide du Panneau de configuration DirectX inclus dans le kit de développement logiciel (SDK) DirectX. Nous avons livré la dernière version du Kit de développement logiciel (SDK) DirectX en juin 2010 ; vous pouvez le télécharger à partir du Centre de téléchargement Microsoft. Vous pouvez définir cet indicateur dans votre application, généralement dans les versions de version uniquement, pour empêcher les utilisateurs finaux d’utiliser l’Panneau de configuration DirectX pour surveiller la façon dont l’application utilise Direct3D.

Note Vous pouvez également définir cet indicateur dans votre application pour empêcher les outils de débogage Direct3D, tels que Visual Studio Ultimate 2012, de raccorder votre application.

 

Windows 8.1 : cet indicateur n’empêche pas Visual Studio 2013 et les versions ultérieures s’exécutant sur Windows 8.1 et versions ultérieures de raccorder votre application. Toutefois, cet indicateur empêche toujours Visual Studio 2013 et les versions ultérieures s’exécutant sur Windows 8 et les versions antérieures de raccorder votre application.

Direct3D 11 : Cette valeur n’est pas prise en charge avant Direct3D 11.1.
D3D10_CREATE_DEVICE_STRICT_VALIDATION
Valeur : 0x200
Réservé. Cet indicateur n’est actuellement pas pris en charge. Ne pas utiliser.
D3D10_CREATE_DEVICE_DEBUGGABLE
Valeur : 0x400
Fait en sorte que le périphérique et le pilote conservent les informations que vous pouvez utiliser pour le débogage du nuanceur. L’impact exact de cet indicateur varie d’un pilote à l’autre. Pour utiliser cet indicateur, vous devez avoir D3D11_1SDKLayers.dll installé ; sinon, la création de l’appareil échoue. L’appareil créé prend en charge la couche de débogage. Pour obtenir D3D11_1SDKLayers.dll, vous devez installer le Kit de développement logiciel (SDK) pour Windows 8.

Direct3D 11 : Cette valeur n’est pas prise en charge avant Direct3D 11.1.

Remarques

Les indicateurs de création d’appareil sont utilisés par D3D10CreateDevice et D3D10CreateDeviceAndSwapChain.

Une application peut créer (et détruire) dynamiquement des threads pour améliorer les performances, en particulier sur une machine avec plusieurs cœurs de processeur. Toutefois, il peut arriver qu’une application ait besoin d’empêcher la création de threads supplémentaires. Cela peut se produire lorsque vous souhaitez simplifier le débogage, profiler du code ou développer un outil pour instance. Dans ce cas, utilisez D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONS pour demander au runtime et au pilote vidéo de ne pas créer de threads supplémentaires susceptibles d’interférer avec l’application.

Configuration requise

Condition requise Valeur
En-tête d3d10.h

Voir aussi

Énumérations principales