Share via

Metode IDirectDrawSurface7::SetPalette (ddraw.h)

  • Artikel

Melampirkan objek palet ke (atau melepaskan satu dari) permukaan. Permukaan menggunakan palet ini untuk semua operasi berikutnya. Perubahan palet segera terjadi, tanpa memperhatikan waktu refresh.

Sintaks

HRESULT SetPalette(
  [in] LPDIRECTDRAWPALETTE unnamedParam1
);

Parameter

[in] unnamedParam1

Penunjuk ke antarmuka IDirectDrawPalette untuk objek palet yang akan digunakan dengan permukaan ini. Jika NULL, palet saat ini akan dilepas.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan DD_OK.

Jika gagal, metode dapat mengembalikan salah satu nilai kesalahan berikut:

  • DDERR_GENERIC
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_INVALIDPIXELFORMAT
  • DDERR_INVALIDSURFACETYPE
  • DDERR_NOEXCLUSIVEMODE
  • DDERR_NOPALETTEATTACHED
  • DDERR_NOPALETTEHW
  • DDERR_NOT8BITCOLOR
  • DDERR_SURFACELOST
  • DDERR_UNSUPPORTED

Keterangan

Saat Anda memanggil SetPalette untuk mengatur palet ke permukaan untuk pertama kalinya, SetPalette menambah jumlah referensi palet; panggilan berikutnya ke SetPalette tidak memengaruhi jumlah referensi palet. Jika Anda meneruskan NULL sebagai parameter lpDDPalette , palet dihapus dari permukaan, dan jumlah referensi palet dikurangi. Jika Anda tidak menghapus palet, permukaan secara otomatis melepaskan referensinya ke palet ketika permukaan itu sendiri dilepaskan. Menurut aturan COM, aplikasi Anda harus merilis referensi apa pun yang disimpannya ke palet ketika objek tidak lagi diperlukan.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header ddraw.h
Pustaka Ddraw.lib
DLL Ddraw.dll

Lihat juga

IDirectDrawSurface7