Fungsi DrvDescribePixelFormat (winddi.h)

Fungsi DrvDescribePixelFormat menjelaskan format piksel untuk PDEV yang ditentukan perangkat dengan menulis deskripsi format piksel ke struktur PIXELFORMATDESCRIPTOR.

Sintaks

LONG DrvDescribePixelFormat(
  DHPDEV                dhpdev,
  LONG                  iPixelFormat,
  ULONG                 cjpfd,
  PIXELFORMATDESCRIPTOR *ppfd
);

Parameter

dhpdev

Mengidentifikasi perangkat yang informasi format pikselnya diminta.

iPixelFormat

Menentukan nomor indeks dari format piksel yang diminta.

cjpfd

Menentukan jumlah maksimum byte yang dapat ditulis ke struktur yang ditujukkan oleh ppfd.

ppfd

Penunjuk ke struktur PIXELFORMATDESCRIPTOR (dijelaskan dalam dokumentasi Microsoft Windows SDK) yaitu menerima informasi tentang format piksel. Parameter ini bisa NULL.

Mengembalikan nilai

Nilai yang dikembalikan adalah indeks format piksel maksimum jika fungsi berhasil. Jika tidak, itu adalah nol, dan kode kesalahan dicatat.

Keterangan

Driver tampilan yang mendukung perangkat keras grafis 3D dapat mendukung jendela dengan format piksel yang berbeda pada satu permukaan tampilan. Format piksel harus sesuai dengan konfigurasi yang didukung oleh perangkat keras grafis.

DrvDescribePixelFormat mengisi struktur yang diacu oleh ppfd jika parameter ini bukan NULL.

Indeks format piksel maksimum yang dikembalikan dapat digunakan oleh aplikasi yang perlu mendapatkan indeks format piksel maksimum konteks perangkat. Format piksel yang didukung perangkat diidentifikasi oleh indeks bilangan bulat berbasis satu positif.

Fungsi format piksel digunakan bersama dengan fungsi layanan objek jendela untuk melacak dan memperbarui format piksel jendela pada permukaan tampilan.

Persyaratan

Target Platform	Desktop
Header	winddi.h (termasuk Winddi.h)