Bagikan melalui


Fungsi DescribePixelFormat (wingdi.h)

Fungsi DescribePixelFormat mendapatkan informasi tentang format piksel yang diidentifikasi oleh iPixelFormat perangkat yang terkait dengan hdc. Fungsi ini mengatur anggota struktur PIXELFORMATDESCRIPTOR yang diacu oleh ppfd dengan data format piksel tersebut.

Sintaks

int DescribePixelFormat(
  HDC                     hdc,
  int                     iPixelFormat,
  UINT                    nBytes,
  LPPIXELFORMATDESCRIPTOR ppfd
);

Parameter

hdc

Menentukan konteks perangkat.

iPixelFormat

Indeks yang menentukan format piksel. Format piksel yang didukung konteks perangkat diidentifikasi oleh indeks bilangan bulat berbasis satu positif.

nBytes

Ukuran, dalam byte, dari struktur yang ditujukkan oleh ppfd. Fungsi DescribePixelFormat menyimpan tidak lebih dari nByte byte data ke struktur tersebut. Atur nilai ini ke sizeof(PIXELFORMATDESCRIPTOR).

ppfd

Penunjuk ke struktur PIXELFORMATDESCRIPTOR yang anggotanya mengatur fungsi dengan data format piksel. Fungsi ini menyimpan jumlah byte yang disalin ke struktur dalam anggota nSize struktur. Jika, setelah entri, ppfd adalah NULL, fungsi tidak menulis data ke struktur. Ini berguna ketika Anda hanya ingin mendapatkan indeks format piksel maksimum dari konteks perangkat.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah indeks format piksel maksimum dari konteks perangkat. Selain itu, fungsi ini menetapkan anggota struktur PIXELFORMATDESCRIPTOR yang diacu oleh ppfd sesuai dengan format piksel yang ditentukan.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header wingdi.h
Pustaka Gdi32.lib
DLL Gdi32.dll

Lihat juga

PilihFormatPixel

GetPixelFormat

OpenGL di Windows

SetPixelFormat

Fungsi Windows