enumerazione D3D10_CREATE_DEVICE_FLAG (d3d10.h)
Flag di creazione del dispositivo.
Sintassi
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
} ;
Costanti
D3D10_CREATE_DEVICE_SINGLETHREADEDValore: 0x1 Usare questo flag se un'applicazione chiamerà D3D10 solo da un singolo thread. Se questo flag non viene specificato, il comportamento predefinito di D3D10 consiste nell'immettere un blocco durante ogni chiamata API per impedire che più thread modifichino lo stato interno. Utilizzando questo flag non verranno eseguiti blocchi che possono aumentare leggermente le prestazioni, ma potrebbe comportare un comportamento non definito se D3D10 viene chiamato da più thread. |
D3D10_CREATE_DEVICE_DEBUGValore: 0x2 Creare un dispositivo che supporti il livello di debug. |
D3D10_CREATE_DEVICE_SWITCH_TO_REFValore: 0x4 Creare contemporaneamente una versione software (REF) e hardware (HAL) del dispositivo, che consente a un'applicazione di passare a un fare riferimento al dispositivo per abilitare il debug. Per altre informazioni, vedere l'interfaccia ID3D10SwitchToRef . |
D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONSValore: 0x8 Impedisce la creazione di più thread. Quando questo flag viene usato con un dispositivo WARP, non verranno creati thread aggiuntivi da WARP e da tutti la rasterizzazione verrà eseguita nel thread chiamante. Questo flag non è consigliato per l'uso generale. Vedere la sezione Osservazioni. |
D3D10_CREATE_DEVICE_ALLOW_NULL_FROM_MAPValore: 0x10 Restituisce un puntatore NULL anziché attivare un'eccezione sull'esaurimento della memoria durante le chiamate a Map. Senza questo flag verrà generata un'eccezione in caso di esaurimento della memoria. Valido solo in Windows 7. |
D3D10_CREATE_DEVICE_BGRA_SUPPORTValore: 0x20 Causa l'esito negativo della creazione del dispositivo se il supporto BGRA non è disponibile. Il supporto BGRA abilita i formati seguenti.
D3D10_CREATE_DEVICE_BGRA_SUPPORT è rilevante solo quando viene creato un dispositivo con D3D10CreateDevice1 o D3D10CreateDeviceAndSwapChain1 usando il D3D10_FEATURE_LEVEL_10_0 o il D3D10_FEATURE_LEVEL_10_1 i livelli di funzionalità, il flag verrà ignorato quando viene creato un dispositivo con altri livelli di funzionalità. Si noti che il supporto BGRA può essere presente anche se l'applicazione non ha specificato D3D10_CREATE_DEVICE_BGRA_SUPPORT. Il flag causa semplicemente l'esito negativo della creazione del dispositivo se il supporto BGRA non è disponibile. D3D10_CREATE_DEVICE_BGRA_SUPPORT è valido solo nei sistemi Windows 7, Windows Server 2008 R2 e Windows Vista (KB971644) aggiornati. |
D3D10_CREATE_DEVICE_PREVENT_ALTERING_LAYER_SETTINGS_FROM_REGISTRYValore: 0x80 Fa sì che il runtime Direct3D ignori le impostazioni del Registro di sistema che attivano il livello di debug. È possibile attivare il livello di debug usando il Pannello di controllo DirectX incluso come parte di DirectX SDK. Abbiamo fornito l'ultima versione di DirectX SDK nel giugno 2010; è possibile scaricarlo dall'Area download Microsoft. Puoi impostare questo flag nella tua app, in genere solo nelle build di versione, per impedire agli utenti finali di usare il Pannello di controllo DirectX per monitorare il modo in cui l'app usa Direct3D. Nota Puoi anche impostare questo flag nella tua app per impedire agli strumenti di debug Direct3D, ad esempio Visual Studio Ultimate 2012, di associare l'app. Windows 8.1: questo flag non impedisce Visual Studio 2013 e versioni successive in esecuzione in Windows 8.1 e versioni successive di associare l'app. Tuttavia, questo flag impedisce ancora Visual Studio 2013 e versioni successive in esecuzione su Windows 8 e versioni precedenti di associare l'app. Direct3D 11: Questo valore non è supportato fino a Direct3D 11.1. |
D3D10_CREATE_DEVICE_STRICT_VALIDATIONValore: 0x200 Riservato. Questo flag non è attualmente supportato. Non usare. |
D3D10_CREATE_DEVICE_DEBUGGABLEValore: 0x400 Fa sì che il dispositivo e il driver mantengano le informazioni che è possibile usare per il debug dello shader. L'impatto esatto di questo flag varia da driver a driver. Per usare questo flag, è necessario aver installato D3D11_1SDKLayers.dll; in caso contrario, la creazione del dispositivo non riesce. Il dispositivo creato supporta il livello di debug. Per ottenere D3D11_1SDKLayers.dll, è necessario installare l'SDK per Windows 8. Direct3D 11: Questo valore non è supportato fino a Direct3D 11.1. |
Commenti
I flag di creazione del dispositivo vengono usati da D3D10CreateDevice e D3D10CreateDeviceAndSwapChain.
Un'applicazione potrebbe creare (ed eliminare) dinamicamente thread per migliorare le prestazioni soprattutto in un computer con più core CPU. Possono tuttavia verificarsi casi in cui un'applicazione deve impedire la creazione di thread aggiuntivi. Ciò può verificarsi quando si vuole semplificare il debug, il codice del profilo o sviluppare uno strumento, ad esempio. Per questi casi, usare D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONS per richiedere che il runtime e il driver video non creino thread aggiuntivi che potrebbero interferire con l'applicazione.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | d3d10.h |