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 |