Bagikan melalui

Metode IDirectDrawPalette::GetCaps (ddraw.h)

  • Artikel

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

Lihat juga

IDirectDrawPalette