Struktur DDSCAPS (ddraw.h)
Struktur DDSCAPS mendefinisikan kemampuan objek permukaan Microsoft DirectDraw.
Sintaks
typedef struct _DDSCAPS {
DWORD dwCaps;
} DDSCAPS;
Anggota
dwCaps
Menunjukkan sekumpulan bendera yang menentukan kemampuan permukaan. Anggota ini adalah bitwise ATAU dari salah satu bendera berikut:
| Bendera | Makna |
|---|---|
DDSCAPS_3DDEVICE |
Permukaan ini dapat digunakan untuk penyajian 3D. Aplikasi dapat menggunakan bendera ini untuk memastikan bahwa perangkat yang hanya dapat merender ke tumpukan tertentu memiliki permukaan di luar layar yang dialokasikan dari tumpukan yang benar. Jika bendera ini diatur untuk timbunan, permukaan tidak dialokasikan dari timbunan tersebut. |
DDSCAPS_ALLOCONLOAD |
Memori untuk permukaan tidak dialokasikan sampai permukaan dimuat oleh aplikasi menggunakan metode IDirect3DTexture::Load . |
DDSCAPS_ALPHA |
Permukaan ini hanya berisi informasi alfa. |
DDSCAPS_BACKBUFFER |
Permukaan ini adalah buffer belakang struktur permukaan membalik. Biasanya, kemampuan ini diatur oleh metode CreateSurface aplikasi saat bendera DDSCAPS_FLIP digunakan. Hanya permukaan yang segera mendahului permukaan DDSCAPS_FRONTBUFFER yang memiliki set kemampuan ini. Permukaan lainnya diidentifikasi sebagai buffer belakang dengan adanya bendera DDSCAPS_FLIP, urutan lampirannya, dan tidak adanya kemampuan DDSCAPS_FRONTBUFFER dan DDSCAPS_BACKBUFFER. Jika kemampuan ini dikirim ke metode CreateSurface aplikasi, buffer belakang yang berdiri sendiri sedang dibuat. Setelah metode ini dipanggil, permukaan ini dapat dilampirkan ke buffer depan, buffer belakang lain, atau keduanya untuk membentuk struktur permukaan yang membalik. Untuk informasi selengkapnya, lihat metode AddAttachedSurface di DirectX SDK. DirectDraw mendukung jumlah permukaan sewenang-wenang dalam struktur membalik. |
DDSCAPS_COMPLEX |
Permukaan yang kompleks sedang dijelaskan. Permukaan yang kompleks menghasilkan pembuatan lebih dari satu permukaan. Permukaan tambahan melekat pada permukaan akar. Struktur kompleks hanya dapat dihancurkan dengan menghancurkan akar. |
DDSCAPS_EXECUTEBUFFER |
Permukaan adalah buffer eksekusi, yang merupakan potongan linear sistem atau memori video yang menyimpan daftar tampilan Microsoft Direct3D. Driver melaporkan bit kemampuan ini untuk menunjukkan bahwa ia dapat membuat buffer eksekusi dalam memori video. Jika runtime Direct3D mendeteksi bit ini, runtime tersebut dapat meminta buffer eksekusi dari driver. Aplikasi tidak dapat mendeteksi bit kapabilitas ini. |
DDSCAPS_FLIP |
Permukaan ini adalah bagian dari struktur membalik permukaan. Ketika kemampuan ini diteruskan ke metode CreateSurface aplikasi, buffer depan dan satu atau beberapa buffer belakang dibuat. DirectDraw mengatur bit DDSCAPS_FRONTBUFFER pada permukaan buffer depan dan bit DDSCAPS_BACKBUFFER pada permukaan yang berdekatan dengan permukaan buffer depan. Anggota dwBackBufferCount dari struktur DDSURFACEDESC harus diatur ke setidaknya 1 agar panggilan metode berhasil. Kemampuan DDSCAPS_COMPLEX harus selalu diatur saat membuat beberapa permukaan dengan menggunakan metode CreateSurface . |
DDSCAPS_FRONTBUFFER |
Permukaan ini adalah buffer depan struktur permukaan membalik. Bendera ini biasanya diatur oleh metode CreateSurface aplikasi ketika kemampuan DDSCAPS_FLIP diatur. Jika kemampuan ini dikirim ke metode CreateSurface , buffer depan yang berdiri sendiri dibuat. Permukaan ini tidak memiliki kemampuan DDSCAPS_FLIP. Ini dapat dilampirkan ke buffer belakang lainnya untuk membentuk struktur membalik dengan menggunakan metode AddAttachedSurface aplikasi. |
DDSCAPS_HWCODEC |
Permukaan ini harus dapat memiliki aliran yang didekompresi oleh perangkat keras. |
DDSCAPS_LIVEVIDEO |
Permukaan ini harus dapat menerima video langsung. |
DDSCAPS_LOCALVIDMEM |
Permukaan ini ada dalam memori tampilan lokal yang benar, bukan memori tampilan nonlokal. Jika bendera ini ditentukan, maka DDSCAPS_VIDEOMEMORY juga harus ditentukan. Bendera ini tidak dapat digunakan dengan bendera DDSCAPS_NONLOCALVIDMEM. |
DDSCAPS_MIPMAP |
Permukaan ini adalah satu tingkat mipmap. Permukaan ini melekat pada permukaan DDSCAPS_MIPMAP lain untuk membentuk mipmap. Ini dapat dilakukan secara eksplisit dengan membuat sejumlah permukaan dan melampirkannya dengan menggunakan metode AddAttachedSurface aplikasi, atau secara implisit oleh metode CreateSurface aplikasi. Jika kemampuan ini diatur, DDSCAPS_TEXTURE juga harus diatur. |
DDSCAPS_MODEX |
Permukaan ini adalah permukaan Mode X 320x200 atau 320x240. Jika bit kapabilitas ini diatur oleh driver Microsoft Windows 2000 atau yang lebih baru, DirectDraw dinonaktifkan. |
DDSCAPS_NONLOCALVIDMEM |
Permukaan ini ada dalam memori tampilan nonlokal daripada memori tampilan lokal yang benar. Jika bendera ini ditentukan, maka bendera DDSCAPS_VIDEOMEMORY juga harus ditentukan. Ini tidak dapat digunakan dengan bendera DDSCAPS_LOCALVIDMEM. |
DDSCAPS_OFFSCREENPLAIN |
Permukaan ini adalah permukaan di luar layar yang bukan overlay, tekstur, z-buffer, front-buffer, back-buffer, atau permukaan alfa. Ini digunakan untuk mengidentifikasi permukaan biasa. |
DDSCAPS_OVERLAY |
Permukaan ini adalah overlay. Visibilitas overlay ini tergantung pada apakah saat ini sedang dilapisi ke permukaan utama. DDSCAPS_VISIBLE dapat digunakan untuk menentukan apakah sedang dilapisi saat ini. |
DDSCAPS_OPTIMIZED |
Bendera ini saat ini tidak diimplementasikan. |
DDSCAPS_OWNDC |
Permukaan ini akan memiliki asosiasi konteks perangkat (DC) untuk jangka waktu yang lama. Jika bit kemampuan ini diatur oleh driver Windows 2000 atau yang lebih baru, DirectDraw akan dinonaktifkan. |
DDSCAPS_PALETTE |
Driver perangkat ini memungkinkan objek DirectDrawPalette unik untuk dibuat dan dilampirkan ke permukaan ini. |
DDSCAPS_PRIMARYSURFACE |
Permukaan ini adalah permukaan utama. Ini mewakili apa yang terlihat oleh pengguna saat ini. |
DDSCAPS_PRIMARYSURFACELEFT |
Permukaan ini adalah permukaan utama untuk mata kiri. Ini mewakili apa yang terlihat oleh mata kiri pengguna saat ini. Ketika permukaan ini dibuat, permukaan dengan kemampuan DDSCAPS_PRIMARYSURFACE mewakili apa yang terlihat oleh mata kanan pengguna. |
DDSCAPS_STANDARDVGAMODE |
Permukaan ini adalah permukaan mode VGA standar, dan bukan permukaan ModeX. Bendera ini tidak dapat digunakan dalam kombinasi dengan bendera DDSCAPS_MODEX. |
DDSCAPS_SYSTEMMEMORY |
Memori permukaan ini dialokasikan dari memori sistem. Jika bit kemampuan ini diatur oleh driver Windows 2000 atau yang lebih baru, DirectDraw dinonaktifkan. |
DDSCAPS_TEXTURE |
Permukaan ini dapat digunakan sebagai tekstur 3D. Ini tidak menunjukkan apakah permukaan sedang digunakan untuk tujuan itu. |
DDSCAPS_VIDEOMEMORY |
Permukaan ini ada dalam memori tampilan. |
DDSCAPS_VIDEOPORT |
Permukaan ini dapat menerima data dari objek ekstensi port video (VPE ). |
DDSCAPS_VISIBLE |
Perubahan yang dilakukan pada permukaan ini segera terlihat. Ini selalu diatur untuk permukaan utama, serta untuk overlay saat sedang dilapisi dan peta tekstur saat sedang diteksur. |
DDSCAPS_WRITEONLY |
Hanya akses tulis yang diizinkan ke permukaan. Akses baca dari permukaan dapat menghasilkan kesalahan perlindungan umum (GPF), tetapi hasil baca dari permukaan ini tidak bermakna. Jika bit kemampuan ini diatur oleh driver Windows 2000 atau yang lebih baru, DirectDraw dinonaktifkan. |
DDSCAPS_ZBUFFER |
Permukaan ini adalah z-buffer. Ini berisi informasi kedalaman bit yang digunakan untuk menentukan piksel mana yang terlihat dan mana yang dikaburkan. Z-buffer berisi informasi yang tidak dapat ditampilkan. |
Keterangan
Struktur ini digunakan oleh driver untuk melaporkan jenis permukaan yang didukung driver. Ini juga diisi oleh aplikasi untuk menentukan jenis permukaan yang akan dibuat.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | ddraw.h |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk