Struktur DDSURFACEDATA (dxmini.h)
Struktur DDSURFACEDATA digunakan oleh DirectDraw untuk mewakili permukaan ke driver miniport mode kernel.
Sintaks
typedef struct _DDSURFACEDATA {
DWORD ddsCaps;
DWORD dwSurfaceOffset;
ULONG_PTR fpLockPtr;
DWORD dwWidth;
DWORD dwHeight;
LONG lPitch;
DWORD dwOverlayFlags;
DWORD dwOverlayOffset;
DWORD dwOverlaySrcWidth;
DWORD dwOverlaySrcHeight;
DWORD dwOverlayDestWidth;
DWORD dwOverlayDestHeight;
DWORD dwVideoPortId;
DWORD dwFormatFlags;
DWORD dwFormatFourCC;
DWORD dwFormatBitCount;
DWORD dwRBitMask;
DWORD dwGBitMask;
DWORD dwBBitMask;
ULONG dwDriverReserved1;
ULONG dwDriverReserved2;
ULONG dwDriverReserved3;
ULONG dwDriverReserved4;
} DDSURFACEDATA, *LPDDSURFACEDATA;
Anggota
ddsCaps
Menunjuk ke struktur DDSCAPS yang berisi kemampuan pembuatan yang digunakan untuk menggambarkan permukaan.
dwSurfaceOffset
Menentukan offset byte dari awal buffer bingkai ke awal permukaan. Bidang ini hanya digunakan oleh driver miniport.
fpLockPtr
Menunjuk ke awal permukaan.
dwWidth
Menentukan lebar permukaan, dalam piksel.
dwHeight
Menentukan tinggi permukaan, dalam piksel.
lPitch
Menentukan permukaan pitch, dalam byte.
dwOverlayFlags
Menunjukkan sekumpulan bendera yang menentukan bendera mode pengguna saat ini DDOVER_Xxx yang ditetapkan oleh DdUpdateOverlay. Anggota ini adalah bitwise ATAU dari salah satu nilai berikut:
| Bendera | Makna |
|---|---|
| DDOVER_ADDDIRTYRECT | Tambahkan persegi kotor ke permukaan yang dilapisi. |
| DDOVER_ALPHADEST | Gunakan informasi alfa dalam format piksel atau permukaan saluran alfa yang terpasang pada permukaan tujuan sebagai saluran alfa untuk overlay ini. |
| DDOVER_ALPHADESTCONSTOVERRIDE | Gunakan anggota dwAlphaDestConst dari struktur DDOVERLAYFX sebagai saluran alfa tujuan untuk overlay ini. Struktur DDOVERLAYFX didefinisikan dalam ddraw.h. |
| DDOVER_ALPHADESTNEG | Permukaan tujuan menjadi lebih transparan karena nilai alfa meningkat (0 buram). |
| DDOVER_ALPHADESTSURFACEOVERRIDE | Gunakan anggota lpDDSAlphaDest dari struktur DDOVERLAYFX (didefinisikan dalam dokumentasi DirectDraw SDK) sebagai tujuan saluran alfa untuk overlay ini. |
| DDOVER_ALPHAEDGEBLEND | Gunakan anggota dwAlphaEdgeBlend dari struktur DDOVERLAYFX (didefinisikan dalam dokumentasi DirectDraw SDK) sebagai saluran alfa untuk tepi gambar yang berbatasan dengan warna kunci warna. |
| DDOVER_ALPHASRC | Gunakan informasi alfa dalam format piksel atau permukaan saluran alfa yang terpasang pada permukaan sumber sebagai saluran alfa sumber untuk overlay ini. |
| DDOVER_ALPHASRCCONSTOVERRIDE | Gunakan anggota dwAlphaSrcConst dari struktur DDOVERLAYFX (didefinisikan dalam dokumentasi DirectDraw SDK) sebagai saluran alfa sumber untuk overlay ini. |
| DDOVER_ALPHASRCNEG | Permukaan sumber menjadi lebih transparan saat nilai alfa meningkat (0 buram). |
| DDOVER_ALPHASRCSURFACEOVERRIDE | Gunakan anggota lpDDSAlphaSrc dari struktur DDOVERLAYFX (didefinisikan dalam dokumentasi DirectDraw SDK) sebagai sumber saluran alfa untuk overlay ini. |
| DDOVER_AUTOFLIP | Secara otomatis membalik ke permukaan berikutnya dalam rantai balik setiap kali port video perangkat keras VSYNC terjadi. |
| DDOVER_BOB | Tampilkan setiap bidang aliran video yang diselingi satu per satu tanpa menyebabkan artefak apa pun. |
| DDOVER_BOBHARDWARE | Bob dilakukan menggunakan perangkat keras daripada perangkat lunak atau ditimulasi. |
| DDOVER_DDFX | Gunakan bendera FX overlay untuk menentukan efek overlay khusus. |
| DDOVER_HIDE | Matikan overlay ini. |
| DDOVER_INTERLEAVED | Memori permukaan terdiri dari bidang yang diselingi. |
| DDOVER_KEYDEST | Gunakan kunci warna yang terkait dengan permukaan tujuan. |
| DDOVER_KEYDESTOVERRIDE | Gunakan anggota dckDestColorkey dari struktur DDOVERLAYFX (didefinisikan dalam dokumentasi DirectDraw SDK) sebagai kunci warna untuk permukaan tujuan. |
| DDOVER_KEYSRC | Gunakan kunci warna yang terkait dengan permukaan sumber. |
| DDOVER_KEYSRCOVERRIDE | Gunakan anggota dckSrcColorkey dari struktur DDOVERLAYFX (didefinisikan dalam dokumentasi DirectDraw SDK) sebagai kunci warna untuk permukaan sumber. |
| DDOVER_OVERRIDEBOBWEAVE | Keputusan Bob dan weave tidak boleh ditimpa oleh antarmuka lain. Jika bendera ini diatur, DirectDraw tidak mengizinkan driver mode kernel untuk menggunakan fungsionalitas transportasi video mode kernel untuk mengalihkan perangkat keras antara mode bob dan tenun. |
| DDOVER_REFRESHALL | Gambar ulang seluruh permukaan pada permukaan yang ditiru. |
| DDOVER_REFRESHDIRTYRECTS | Gambar ulang semua persegi panjang kotor pada permukaan yang dilapisi. |
| DDOVER_SHOW | Nyalakan overlay ini. |
dwOverlayOffset
Menentukan offset byte dari awal buffer bingkai hingga awal overlay. Bidang ini hanya digunakan oleh driver miniport.
dwOverlaySrcWidth
Menentukan lebar sumber overlay, dalam piksel. Bidang ini hanya digunakan oleh driver miniport.
dwOverlaySrcHeight
Menentukan tinggi sumber overlay, dalam piksel. Bidang ini hanya digunakan oleh driver miniport.
dwOverlayDestWidth
Menentukan lebar tujuan overlay, dalam piksel. Bidang ini hanya digunakan oleh driver miniport.
dwOverlayDestHeight
Menentukan tinggi tujuan overlay, dalam piksel. Bidang ini hanya digunakan oleh driver miniport.
dwVideoPortId
Jika permukaan ini diberi makan oleh objek ekstensi port video (VPE ), bidang ini menunjukkan ID objek VPE, bilangan bulat dalam rentang (0 - (jumlah maksimum port video perangkat keras -1 )); jika tidak, bidang ini adalah -1.
dwFormatFlags
Menentukan sekumpulan bendera kontrol format piksel. Anggota ini adalah bitwise ATAU dari salah satu nilai berikut:
| Bendera | Makna |
|---|---|
| DDPF_ALPHA | Format piksel menjelaskan permukaan khusus alfa. |
| DDPF_ALPHAPIXELS | Permukaan memiliki informasi saluran alfa dalam format piksel. |
| DDPF_ALPHAPREMULT | Komponen warna dalam piksel telah dikutip sebelumnya oleh nilai alfa dalam piksel. Jika bendera ini diatur, bendera DDPF_ALPHAPIXELS juga harus diatur. Jika bendera ini tidak diatur tetapi bendera DDPF_ALPHAPIXELS diatur, komponen warna dalam format piksel tidak diisi sebelumnya oleh alfa. Dalam hal ini, komponen warna harus dikalikan dengan nilai alfa pada saat operasi alpha-blending dilakukan. |
| DDPF_BUMPDUDV | Peta benjolan data dUdV dalam format piksel valid. |
| DDPF_BUMPLUMINANCE | Data luminance dalam format piksel valid. Bendera ini digunakan saat menggantung luminance dari permukaan bumpmap. Bitmask untuk bagian luminance piksel kemudian ditunjukkan oleh anggota dwBumpLuminanceBitCount dari struktur DDPIXELFORMAT . |
| DDPF_COMPRESSED | Permukaan akan menerima data piksel dalam format yang ditentukan dan mengompresinya selama operasi tulis. |
| DDPF_FOURCC | Kode FOURCC valid. |
| DDPF_LUMINANCE | Data luminance dalam format piksel valid. Bendera ini hanya digunakan untuk luminance atau luminance ditambah permukaan alfa; kedalaman bit kemudian ditunjukkan oleh anggota dwLuminanceBitCount dari struktur DDPIXELFORMAT . |
| DDPF_PALETTEINDEXED1 | Permukaan diindeks warna 1--bit. |
| DDPF_PALETTEINDEXED2 | Permukaan diindeks warna 2--bit. |
| DDPF_PALETTEINDEXED4 | Permukaan diindeks warna 4--bit. |
| DDPF_PALETTEINDEXED8 | Permukaannya diindeks warna 8-bit. |
| DDPF_PALETTEINDEXEDTO8 | Permukaannya adalah warna 1,2-, atau 4-bit yang diindeks ke palet 8-bit. |
| DDPF_RGB | Data RGB dalam struktur format piksel valid. |
| DDPF_RGBTOYUV | Permukaan akan menerima data RGB dan menerjemahkannya selama operasi tulis ke data YUV. Format data yang akan ditulis akan terkandung dalam struktur format piksel. Bendera DDPF_RGB akan diatur. |
| DDPF_STENCILBUFFER | Permukaan berisi informasi stensil bersama dengan informasi Z. |
| DDPF_YUV | Data YUV dalam struktur format piksel valid. |
| DDPF_ZBUFFER | Format piksel menjelaskan permukaan z-buffer-only. |
| DDPF_ZPIXELS | Permukaannya dalam format RGBZ. |
dwFormatFourCC
Menentukan kode FOURCC .
dwFormatBitCount
Menentukan jumlah bit per piksel (4, 8, 16, 24, atau 32).
dwRBitMask
Menentukan bitmask merah.
dwGBitMask
Menentukan bitmask hijau.
dwBBitMask
Menentukan bitmask biru.
dwDriverReserved1
Dicadangkan untuk HAL/Miniport
dwDriverReserved2
Dicadangkan untuk HAL/Miniport
dwDriverReserved3
Dicadangkan untuk HAL/Miniport
dwDriverReserved4
Dicadangkan untuk digunakan oleh driver miniport.
Persyaratan
| Header | dxmini.h (termasuk Dxmini.h) |