struktur D3DDDI_RESOURCEFLAGS (d3dukmdt.h)
Struktur D3DDDI_RESOURCEFLAGS mengidentifikasi jenis sumber daya yang akan dibuat dalam panggilan ke fungsi CreateResource driver.
typedef struct _D3DDDI_RESOURCEFLAGS {
union {
struct {
UINT RenderTarget : 1;
UINT ZBuffer : 1;
UINT Dynamic : 1;
UINT HintStatic : 1;
UINT AutogenMipmap : 1;
UINT DMap : 1;
UINT WriteOnly : 1;
UINT NotLockable : 1;
UINT Points : 1;
UINT RtPatches : 1;
UINT NPatches : 1;
UINT SharedResource : 1;
UINT DiscardRenderTarget : 1;
UINT Video : 1;
UINT CaptureBuffer : 1;
UINT Primary : 1;
UINT Texture : 1;
UINT CubeMap : 1;
UINT Volume : 1;
UINT VertexBuffer : 1;
UINT IndexBuffer : 1;
UINT DecodeRenderTarget : 1;
UINT DecodeCompressedBuffer : 1;
UINT VideoProcessRenderTarget : 1;
UINT CpuOptimized : 1;
UINT MightDrawFromLocked : 1;
UINT Overlay : 1;
UINT MatchGdiPrimary : 1;
UINT InterlacedRefresh : 1;
UINT TextApi : 1;
UINT RestrictedContent : 1;
UINT RestrictSharedAccess : 1;
};
UINT Value;
};
} D3DDDI_RESOURCEFLAGS;
RenderTarget
Mengatur anggota ini setara dengan mengatur bit pertama dari anggota Nilai 32-bit (0x00000001).
ZBuffer
Nilai UINT yang menentukan apakah permukaan adalah z-buffer. Z-buffer berisi informasi kedalaman bit yang digunakan untuk menentukan piksel mana yang terlihat dan mana yang dikaburkan. Z-buffer berisi informasi yang tidak dapat ditampilkan.
Mengatur anggota ini setara dengan mengatur bit kedua dari anggota Nilai 32-bit (0x00000002).
Dynamic
Nilai UINT yang menentukan apakah permukaan sering diperbarui. Bendera bit-field ini tidak dapat digunakan dengan bendera HintStatic bit-field.
Mengatur anggota ini setara dengan mengatur bit ketiga dari anggota Nilai 32-bit (0x00000004).
HintStatic
Nilai UINT yang menentukan apakah permukaan jarang diperbarui tetapi masih harus mengizinkan akses. Bendera bit-field ini tidak dapat digunakan dengan bendera bit-field Dynamic.
Mengatur anggota ini setara dengan mengatur bit keempat dari anggota Nilai 32-bit (0x00000008).
AutogenMipmap
Nilai UINT yang menentukan apakah sublevel peta MIP untuk permukaan dibuat secara otomatis.
Mengatur anggota ini setara dengan mengatur bit kelima dari anggota Nilai 32-bit (0x00000010).
DMap
Nilai UINT yang menentukan apakah permukaan adalah tekstur peta perpindahan yang dapat diambil sampel sampler peta perpindahannya di unit tessellation.
Mengatur anggota ini setara dengan mengatur bit keenam dari anggota Nilai 32-bit (0x00000020).
WriteOnly
Nilai UINT yang menentukan apakah permukaan hanya dapat ditulis. Akses baca dari permukaan dapat menghasilkan kesalahan perlindungan umum (GPF). Jika permukaan dibaca dari, hasil baca tidak bermakna.
Mengatur anggota ini setara dengan mengatur bit ketujuh dari anggota Nilai 32-bit (0x00000040).
NotLockable
Nilai UINT yang menentukan apakah target render dapat dikunci. Bendera bit-field ini diatur pada buffer utama dan belakang jika rantai balik tidak dapat dikunci, atau pada target render apa pun yang tidak dapat dikunci. Driver kemudian dapat melakukan pengoptimalan latar belakang.
Bahkan jika bendera ini diatur, permukaan masih dapat dikunci, sehingga driver harus menangani situasi ini. Namun, kunci tersebut jarang terjadi dan tidak diharapkan cepat.
Driver juga dapat menentukan apakah kedalaman atau buffer stensil dapat dikunci dengan adanya bendera bit-field ini.
Mengatur anggota ini setara dengan mengatur bit kedelapan dari anggota Nilai 32-bit (0x00000080).
Points
Nilai UINT yang menentukan apakah permukaan berisi data buffer vertex yang dapat digunakan untuk merender titik dan sprite titik.
Mengatur anggota ini setara dengan mengatur bit kesembilan dari anggota Nilai 32-bit (0x00000100).
RtPatches
Nilai UINT yang menentukan apakah permukaan berisi data buffer vertex yang dapat digunakan untuk merender rt-patch.
Mengatur anggota ini setara dengan mengatur bit kesepuluh dari anggota Nilai 32-bit (0x00000200).
NPatches
Nilai UINT yang menentukan apakah permukaan berisi data buffer vertex yang dapat digunakan untuk merender n-patch.
Mengatur anggota ini setara dengan mengatur bit ke-sebelas dari anggota Nilai 32-bit (0x00000400).
SharedResource
Nilai UINT yang menentukan apakah beberapa perangkat dan proses berbagi permukaan.
Mengatur anggota ini setara dengan mengatur bit ke-dua belas dari anggota Nilai 32-bit (0x00000800).
DiscardRenderTarget
Nilai UINT yang menentukan apakah pelestarian permukaan diperlukan. Jika permukaan digunakan sebagai target render, pelestariannya tidak diperlukan.
Mengatur anggota ini setara dengan mengatur bit ketiga belas dari anggota Nilai 32-bit (0x00001000).
Video
Nilai UINT yang menentukan apakah permukaan adalah target render yang berisi data video.
Perhatikan bahwa beberapa target render dapat dibuat dengan bendera ini, dan jika dua atau beberapa target render ini termasuk dalam konteks Microsoft Direct3D yang sama, driver menentukan bahwa target render ini semuanya harus menampilkan aliran video yang sama terlepas dari apakah permukaan target render dilampirkan satu sama lain.
Mengatur anggota ini setara dengan mengatur bit keempat belas dari anggota Nilai 32-bit (0x00002000).
CaptureBuffer
Nilai UINT yang menentukan apakah sumber daya adalah buffer pengambilan.
Mengatur anggota ini setara dengan mengatur bit kelima belas dari anggota Nilai 32-bit (0x00004000).
Primary
Nilai UINT yang menentukan apakah permukaan adalah permukaan utama--yaitu, apakah permukaan saat ini terlihat oleh pengguna.
Mengatur anggota ini setara dengan mengatur bit keenam belas dari anggota Nilai 32-bit (0x00008000).
Texture
Nilai UINT yang menentukan apakah permukaan dapat digunakan sebagai tekstur.
Mengatur anggota ini setara dengan mengatur bit ketujuh belas dari anggota Nilai 32-bit (0x00010000).
CubeMap
Nilai UINT yang menentukan apakah permukaan adalah peta lingkungan kubik. Bendera bit-field ini mengharuskan Tekstur bendera bit-field diatur.
Mengatur anggota ini setara dengan mengatur bit kedelapan belas dari anggota Nilai 32-bit (0x00020000).
Volume
Nilai UINT yang menentukan apakah permukaan memiliki kedalaman, selain lebar dan tinggi--yaitu, apakah permukaan adalah volume. Bendera bit-field ini mengharuskan Tekstur bendera bit-field diatur.
Mengatur anggota ini setara dengan mengatur bit kesembilan belas dari anggota Nilai 32-bit (0x00040000).
VertexBuffer
Nilai UINT yang menentukan apakah permukaan adalah buffer vertex (yaitu, menyimpan simpul).
Mengatur anggota ini setara dengan mengatur bit dua puluh dari anggota Nilai 32-bit (0x00080000).
IndexBuffer
Nilai UINT yang menentukan apakah permukaan adalah buffer indeks (yaitu, menyimpan indeks).
Mengatur anggota ini setara dengan mengatur bit dua puluh pertama dari anggota Nilai 32-bit (0x00100000).
DecodeRenderTarget
Nilai UINT yang menentukan apakah permukaan digunakan sebagai target render untuk dekode Microsoft DirectX Video Acceleration (DirectX VA).
Mengatur anggota ini setara dengan mengatur bit dua puluh detik dari anggota Nilai 32-bit (0x00200000).
DecodeCompressedBuffer
Nilai UINT yang menentukan apakah permukaan berisi informasi buffer terkompresi untuk decoding Va DirectX.
Mengatur anggota ini setara dengan mengatur bit dua puluh ketiga dari anggota Nilai 32-bit (0x00400000).
VideoProcessRenderTarget
Nilai UINT yang menentukan apakah permukaan digunakan sebagai target render untuk pemrosesan video DirectX VA.
Mengatur anggota ini setara dengan mengatur bit dua puluh empat dari anggota Nilai 32-bit (0x00800000).
CpuOptimized
Nilai UINT yang menentukan apakah CPU sering mengakses sumber daya.
Driver harus menempatkan sumber daya di kumpulan memori yang dapat diakses CPU dengan cepat (misalnya, memori AGP). Driver miniport tampilan harus menandai memori sebagai dapat di-cache dengan mengatur bendera cache bit-field di bendera anggota struktur DXGK_ALLOCATIONINFO ketika fungsi DxgkDdiCreateAllocation dipanggil.
Bendera CpuOptimized biasanya diatur untuk target render (target render dan tekstur yang berdiri sendiri).
Mengatur anggota ini setara dengan mengatur bit dua puluh lima dari anggota Nilai 32-bit (0x01000000).
MightDrawFromLocked
Nilai UINT yang menentukan apakah driver mungkin diminta untuk menarik dari buffer vertex meskipun buffer vertex dikunci oleh runtime Direct3D. Permintaan ini berarti bahwa driver dapat, kadang-kadang, menerima panggilan ke DrawIndexedPrimitive , DrawIndexedPrimitive2, drawPrimitive, dan DrawPrimitive2 fungsi di mana data vertex direferensikan dalam buffer vertex terkunci yang ditandai dengan MightDrawFromLocked. Runtime harus melakukan jenis panggilan ini dalam skenario di mana ia melakukan transformasi dan pencahayaan perangkat lunak (bukan perangkat keras). Skenario ini biasanya tidak terjadi.
Namun, karena runtime mengunci buffer vertex, driver tidak dapat memanggil fungsi pfnUnlockCb sebelum memanggil fungsi pfnRenderCb. Akibatnya, driver harus mendukung buffer vertex dalam segmen memori sistem atau AGP; jika tidak, manajer memori video menolak penyajian. Driver tidak diperlukan untuk mengambil tindakan khusus lainnya karena runtime tidak akan menimpa data apa pun di buffer vertex terkunci ketika perangkat keras aktif merender dari buffer vertex.
Mengatur anggota ini setara dengan mengatur bit dua puluh enam dari anggota Nilai 32-bit (0x02000000).
Overlay
Nilai UINT yang menentukan apakah sumber daya adalah overlay.
Mengatur anggota ini setara dengan mengatur bit dua puluh tujuh dari anggota Nilai 32-bit (0x04000000).
MatchGdiPrimary
Nilai UINT yang menentukan apakah sumber daya adalah permukaan utama yang cocok dengan semua properti permukaan utama GDI saat ini yang dibuat dengan menggunakan struktur D3DKMDT_SHAREDPRIMARYSURFACEDATA. Misalnya, membalik dari permukaan utama yang cocok ke permukaan utama GDI saat ini dan sebaliknya dimungkinkan.
Mengatur anggota ini setara dengan mengatur bit dua puluh delapan dari anggota Nilai 32-bit (0x08000000).
InterlacedRefresh
Nilai UINT yang menentukan apakah sumber daya adalah permukaan utama yang dimaksudkan untuk digunakan dalam mode tampilan terjalin.
Mengatur anggota ini setara dengan mengatur bit dua puluh sembilan dari anggota Nilai 32-bit (0x10000000).
TextApi
Nilai UINT yang menentukan apakah sumber daya dapat digunakan untuk pemfilteran tekstur atau sebagai sumber aliran input. Jika tekstur dibuat dengan kumpulan bendera TextApi bit-field, tekstur tersebut tidak dapat digunakan untuk pemfilteran tekstur. Jika buffer vertex dibuat dengan set bendera TextApi bit-field, buffer tidak dapat digunakan sebagai sumber aliran input. Bendera TextApi bit-field harus ditentukan untuk buffer vertex dan permukaan sumber yang digunakan dalam panggilan ke fungsi ComposeRects.
Mengatur anggota ini setara dengan mengatur bit tiga puluh dari anggota Nilai 32-bit (0x20000000).
RestrictedContent
Didukung di Windows 7 dan versi yang lebih baru.
Nilai UINT yang menentukan apakah sumber daya berisi konten yang dilindungi. Dalam kebanyakan situasi, aplikasi telah secara eksplisit mengaktifkan perlindungan konten sebelum aplikasi membuat sumber daya terbatas. Namun, aplikasi tidak harus secara eksplisit mengaktifkan perlindungan konten jika membuat swapchain mode eksklusif layar penuh terbatas.
Mengatur anggota ini setara dengan mengatur bit tiga puluh pertama dari anggota Nilai 32-bit (0x40000000).
RestrictSharedAccess
Didukung di Windows 7 dan versi yang lebih baru.
Nilai UINT yang menentukan apakah runtime hanya mengizinkan akses proses tertentu ke sumber daya bersama.
Mengatur anggota ini setara dengan mengatur bit tiga puluh detik dari anggota Nilai 32-bit (0x80000000).
Value
Nilai 32-bit yang mengidentifikasi jenis sumber daya yang akan dibuat.
| Syarat | Nilai |
|---|---|
| klien minimum yang didukung | Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru. |
| Header | d3dukmdt.h (termasuk D3dumddi.h, D3dkmddi.h) |