Metode IDirectDrawPalette::GetCaps (ddraw.h)
Mengambil kemampuan objek palet.
Sintaks
HRESULT GetCaps(
[out] LPDWORD unnamedParam1
);
Parameter
[out] unnamedParam1
Penunjuk ke variabel yang menerima nilai dari anggota dwPalCaps dari struktur DDCAPS yang menentukan kemampuan palet. Nilai ini terdiri dari satu atau beberapa bendera berikut.
DDPCAPS_1BIT
Indeksnya adalah 1 bit. Ada dua entri dalam tabel warna.
DDPCAPS_2BIT
Indeksnya adalah 2 bit. Ada empat entri dalam tabel warna.
DDPCAPS_4BIT
Indeksnya adalah 4 bit. Ada 16 entri dalam tabel warna.
DDPCAPS_8BIT
Indeksnya adalah 8 bit. Ada 256 entri dalam tabel warna.
DDPCAPS_8BITENTRIES
Indeks mengacu pada indeks warna 8-bit. Bendera ini hanya berlaku saat digunakan dengan bendera DDPCAPS_1BIT, DDPCAPS_2BIT, atau DDPCAPS_4BIT, dan ketika permukaan target adalah 8 bpp. Setiap entri warna panjangnya 1 byte dan merupakan indeks ke palet 8 bpp permukaan tujuan.
DDPCAPS_ALPHA
Anggota peFlags dari struktur PALETTEENTRY terkait harus ditafsirkan sebagai nilai alfa 8-bit tunggal (selain anggota peRed, peGreen, dan peBlue ). Palet yang dibuat dengan bendera ini hanya dapat dilampirkan ke tekstur: permukaan yang dibuat dengan bendera kemampuan DDSCAPS_TEXTURE.
DDPCAPS_ALLOW256
Palet ini dapat memiliki semua 256 entri yang ditentukan.
DDPCAPS_PRIMARYSURFACE
Palet ini melekat pada permukaan utama. Mengubah tabel warna palet ini segera memengaruhi tampilan kecuali DDPSETPAL_VSYNC ditentukan dan didukung.
DDPCAPS_PRIMARYSURFACELEFT
Palet ini adalah palet yang melekat pada permukaan primer mata kiri. Mengubah tabel warna palet ini segera memengaruhi tampilan mata kiri kecuali DDPSETPAL_VSYNC ditentukan dan didukung.
DDPCAPS_VSYNC
Palet ini dapat memiliki modifikasi pada palet yang disinkronkan dengan laju refresh monitor.
Nilai kembali
Jika metode berhasil, nilai yang dikembalikan DD_OK.
Jika gagal, metode dapat mengembalikan salah satu nilai kesalahan berikut:
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | ddraw.h |
| Pustaka | Ddraw.lib |
| DLL | Ddraw.dll |