enumerasi D3D10_CREATE_DEVICE_FLAG (d3d10.h)
Bendera pembuatan perangkat.
Sintaks
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
} ;
Konstanta
D3D10_CREATE_DEVICE_SINGLETHREADED Nilai: 0x1 Gunakan bendera ini jika aplikasi hanya akan memanggil D3D10 dari satu utas. Jika bendera ini tidak ditentukan, perilaku default D3D10 adalah memasukkan kunci selama setiap panggilan API untuk mencegah beberapa utas mengubah status internal. Dengan menggunakan bendera ini, tidak ada kunci yang akan diambil yang dapat diambil sedikit meningkatkan performa, tetapi dapat mengakibatkan perilaku yang tidak jelas jika D3D10 dipanggil dari beberapa utas. |
D3D10_CREATE_DEVICE_DEBUG Nilai: 0x2 Buat perangkat yang mendukung lapisan debug. |
D3D10_CREATE_DEVICE_SWITCH_TO_REF Nilai: 0x4 Buat perangkat lunak (REF) dan perangkat keras (HAL) secara bersamaan, yang memungkinkan aplikasi untuk beralih ke mereferensikan perangkat untuk mengaktifkan penelusuran kesalahan. Lihat Antarmuka ID3D10SwitchToRef untuk informasi selengkapnya. |
D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONS Nilai: 0x8 Mencegah beberapa utas dibuat. Ketika bendera ini digunakan dengan perangkat WARP, tidak ada utas tambahan yang akan dibuat oleh WARP dan semua rasterisasi akan terjadi pada utas panggilan. Bendera ini tidak disarankan untuk penggunaan umum. Lihat komentar. |
D3D10_CREATE_DEVICE_ALLOW_NULL_FROM_MAP Nilai: 0x10 Mengembalikan penunjuk NULL alih-alih memicu pengecualian pada kelelahan memori selama pemanggilan ke Peta. Tanpa bendera ini, pengecualian akan dinaikkan pada kelelahan memori. Hanya berlaku pada Windows 7. |
D3D10_CREATE_DEVICE_BGRA_SUPPORT Nilai: 0x20 Menyebabkan pembuatan perangkat gagal jika dukungan BGRA tidak tersedia. Dukungan BGRA memungkinkan format berikut.
D3D10_CREATE_DEVICE_BGRA_SUPPORT hanya relevan saat perangkat dibuat dengan D3D10CreateDevice1 atau D3D10CreateDeviceAndSwapChain1 menggunakan D3D10_FEATURE_LEVEL_10_0 atau D3D10_FEATURE_LEVEL_10_1 tingkat fitur, bendera akan diabaikan saat perangkat dibuat dengan tingkat fitur lainnya. Perhatikan bahwa dukungan BGRA mungkin ada meskipun aplikasi tidak menentukan D3D10_CREATE_DEVICE_BGRA_SUPPORT. Bendera hanya menyebabkan pembuatan perangkat gagal jika dukungan BGRA tidak tersedia. D3D10_CREATE_DEVICE_BGRA_SUPPORT hanya berlaku pada sistem Windows 7, Windows Server 2008 R2, dan Windows Vista (KB971644) yang diperbarui. |
D3D10_CREATE_DEVICE_PREVENT_ALTERING_LAYER_SETTINGS_FROM_REGISTRY Nilai: 0x80 Menyebabkan runtime Direct3D mengabaikan pengaturan registri yang mengaktifkan lapisan debug. Anda dapat mengaktifkan lapisan debug dengan menggunakan Panel Kontrol DirectX yang disertakan sebagai bagian dari DirectX SDK. Kami mengirimkan versi terakhir DirectX SDK pada Juni 2010; Anda dapat mengunduhnya dari Pusat Unduhan Microsoft. Anda dapat mengatur bendera ini di aplikasi Anda, biasanya hanya dalam build rilis, untuk mencegah pengguna akhir menggunakan Panel Kontrol DirectX untuk memantau cara aplikasi menggunakan Direct3D. Catatan Anda juga dapat mengatur bendera ini di aplikasi untuk mencegah alat penelusuran kesalahan Direct3D, seperti Visual Studio Ultimate 2012, agar tidak menghubungkan aplikasi Anda. Windows 8.1: Bendera ini tidak mencegah Visual Studio 2013 dan yang lebih baru berjalan di Windows 8.1 dan yang lebih baru agar tidak menghubungkan aplikasi Anda. Namun, bendera ini masih mencegah Visual Studio 2013 dan yang lebih baru berjalan di Windows 8 dan yang lebih lama dari menghubungkan aplikasi Anda. Direct3D 11: Nilai ini tidak didukung hingga Direct3D 11.1. |
D3D10_CREATE_DEVICE_STRICT_VALIDATION Nilai: 0x200 Dicadangkan. Bendera ini saat ini tidak didukung. Jangan gunakan. |
D3D10_CREATE_DEVICE_DEBUGGABLE Nilai: 0x400 Menyebabkan perangkat dan driver menyimpan informasi yang dapat Anda gunakan untuk penelusuran kesalahan shader. Dampak pasti dari bendera ini akan bervariasi dari driver ke driver. Untuk menggunakan bendera ini, Anda harus menginstal D3D11_1SDKLayers.dll; jika tidak, pembuatan perangkat gagal. Perangkat yang dibuat mendukung lapisan debug. Untuk mendapatkan D3D11_1SDKLayers.dll, Anda harus menginstal SDK untuk Windows 8. Direct3D 11: Nilai ini tidak didukung hingga Direct3D 11.1. |
Keterangan
Bendera pembuatan perangkat digunakan oleh D3D10CreateDevice dan D3D10CreateDeviceAndSwapChain.
Aplikasi mungkin secara dinamis membuat (dan menghancurkan) utas untuk meningkatkan performa terutama pada komputer dengan beberapa inti CPU. Namun, mungkin ada kasus ketika aplikasi perlu mencegah utas tambahan dibuat. Ini dapat terjadi ketika Anda ingin menyederhanakan penelusuran kesalahan, kode profil, atau mengembangkan alat misalnya. Untuk kasus ini, gunakan D3D10_CREATE_DEVICE_PREVENT_INTERNAL_THREADING_OPTIMIZATIONS untuk meminta agar runtime dan driver video tidak membuat utas tambahan yang mungkin mengganggu aplikasi.
Persyaratan
Persyaratan | Nilai |
---|---|
Header | d3d10.h |