énumération D3D10_CREATE_DEVICE_FLAG (d3d10.h)
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_SINGLETHREADEDValeur : 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_DEBUGValeur : 0x2 Créez un appareil qui prend en charge la couche de débogage. |
D3D10_CREATE_DEVICE_SWITCH_TO_REFValeur : 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_OPTIMIZATIONSValeur : 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_MAPValeur : 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_SUPPORTValeur : 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.
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_REGISTRYValeur : 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_VALIDATIONValeur : 0x200 Réservé. Cet indicateur n’est actuellement pas pris en charge. Ne pas utiliser. |
D3D10_CREATE_DEVICE_DEBUGGABLEValeur : 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 |