struktur DD_UPDATEOVERLAYDATA (ddrawint.h)
Struktur DD_UPDATEOVERLAYDATA berisi informasi yang diperlukan untuk memperbarui permukaan overlay.
Sintaks
typedef struct _DD_UPDATEOVERLAYDATA {
PDD_DIRECTDRAW_GLOBAL lpDD;
PDD_SURFACE_LOCAL lpDDDestSurface;
RECTL rDest;
PDD_SURFACE_LOCAL lpDDSrcSurface;
RECTL rSrc;
DWORD dwFlags;
DDOVERLAYFX overlayFX;
HRESULT ddRVal;
VOID *UpdateOverlay;
} *PDD_UPDATEOVERLAYDATA, DD_UPDATEOVERLAYDATA;
Anggota
lpDD
Menunjuk ke struktur DD_DIRECTDRAW_GLOBAL yang menjelaskan perangkat driver.
lpDDDestSurface
Menunjuk ke struktur DD_SURFACE_LOCAL yang mewakili permukaan Microsoft DirectDraw yang akan dilapisi. Nilai ini bisa NULL jika DDOVER_HIDE ditentukan dalam dwFlags.
rDest
Menentukan struktur RECTL yang berisi x, y, lebar, dan tinggi wilayah pada permukaan tujuan yang akan dilapisi.
lpDDSrcSurface
Menunjuk ke struktur DD_SURFACE_LOCAL yang menjelaskan permukaan overlay.
rSrc
Menentukan struktur RECTL yang berisi x, y, lebar, dan tinggi wilayah pada permukaan sumber yang akan digunakan untuk overlay.
dwFlags
Menentukan bagaimana driver harus menangani overlay. Anggota ini bisa menjadi kombinasi dari salah satu bendera berikut:
| Bendera | Makna |
|---|---|
| DDOVER_ADDDIRTYRECT | Harus diabaikan oleh driver. |
| DDOVER_AUTOFLIP | Pengandar harus melakukan autoflip overlay setiap kali port video perangkat keras otomatis terbalik. Driver yang mendukung ekstensi port video (VPE) hanya perlu memeriksa bendera ini. |
| DDOVER_BOB | Driver harus menampilkan setiap bidang data objek VPE satu per satu tanpa menyebabkan artefak jittery. Bendera ini berkaitan dengan VPE dan dekoder yang ingin melakukan pembalikan mereka sendiri dalam mode kernel menggunakan fungsionalitas transportasi video mode kernel. |
| DDOVER_BOBHARDWARE | Menunjukkan bahwa bob dilakukan oleh perangkat keras daripada oleh perangkat lunak atau emulasi. Driver yang mendukung VPE hanya perlu memeriksa bendera ini. |
| DDOVER_DDFX | Driver harus menunjukkan permukaan overlay menggunakan atribut yang ditentukan oleh anggota overlayFX . |
| DDOVER_HIDE | Pengemudi harus menyembunyikan overlay; artinya, driver harus mematikan overlay ini. |
| DDOVER_INTERLEAVED | Permukaan overlay terdiri dari bidang interleaved. Driver yang mendukung VPE hanya perlu memeriksa bendera ini. |
| DDOVER_KEYDEST | Driver harus menggunakan kunci warna yang terkait dengan permukaan tujuan. |
| DDOVER_KEYDESTOVERRIDE | Driver harus menggunakan anggota dckDestColorKey dari struktur DDOVERLAYFX (dijelaskan dalam dokumentasi DirectDraw SDK) sebagai kunci warna tujuan alih-alih kunci warna yang terkait dengan permukaan tujuan. |
| DDOVER_KEYSRC | Driver harus menggunakan kunci warna yang terkait dengan permukaan tujuan. |
| DDOVER_KEYSRCOVERRIDE | Driver harus menggunakan anggota dckSrcColorKey dari struktur DDOVERLAYFX (dijelaskan dalam dokumentasi DirectDraw SDK) sebagai kunci warna sumber alih-alih kunci warna yang terkait dengan permukaan tujuan. |
| DDOVER_OVERRIDEBOBWEAVE | Keputusan Bob/weave tidak boleh ditimpa oleh antarmuka lain. Jika mixer overlay mengatur bendera ini, DirectDraw tidak mengizinkan driver mode kernel untuk menggunakan fungsionalitas transportasi video mode kernel untuk mengalihkan perangkat keras antara mode bob dan tenun. |
| DDOVER_REFRESHALL | Harus diabaikan oleh driver. |
| DDOVER_REFRESHDIRTYRECTS | Harus diabaikan oleh driver. |
| DDOVER_SHOW | Driver harus menunjukkan overlay; artinya, driver harus menyalakan overlay ini. |
overlayFX
Menentukan struktur DDOVERLAYFX (dijelaskan dalam dokumentasi DirectDraw SDK) yang menjelaskan efek tambahan yang harus digunakan driver untuk memperbarui overlay. Driver harus menggunakan struktur ini hanya jika salah satu DDOVER_DDFX, DDOVER_KEYDESTOVERRIDE, atau DDOVER_KEYSRCOVERRIDE diatur dalam anggota dwFlags .
ddRVal
Menentukan lokasi di mana driver menulis nilai pengembalian dari panggilan balik DdUpdateOverlay . Kode pengembalian DD_OK menunjukkan keberhasilan. Untuk informasi selengkapnya, lihat Mengembalikan Nilai untuk DirectDraw.
UpdateOverlay
Digunakan oleh API DirectDraw dan tidak boleh diisi oleh driver.
Persyaratan
| Header | ddrawint.h (termasuk Winddi.h) |