Fungsi DdCreateDIBSection (ddrawgdi.h)

  • Artikel

[Fungsi ini dapat berubah dengan setiap revisi sistem operasi. Sebagai gantinya, gunakan Microsoft DirectDraw dan Microsoft Direct3DAPIs; API ini mengisolasi aplikasi dari perubahan sistem operasi tersebut, dan menyembunyikan banyak kesulitan lain yang terlibat dalam berinteraksi langsung dengan pengandar tampilan.]

Membuat struktur DIBSECTION yang berbagi tabel warnanya dengan perangkat.

GdiEntry9 didefinisikan sebagai alias untuk fungsi ini.

Sintaks

HBITMAP DdCreateDIBSection(
  HDC              hdc,
  const BITMAPINFO *pbmi,
  UINT             iUsage,
  VOID             **ppvBits,
  HANDLE           hSectionApp,
  DWORD            dwOffset
);

Parameter

hdc

DC yang valid kompatibel dengan perangkat tampilan saat ini.

pbmi

Pointer ke struktur BITMAPINFO yang menjelaskan DIBSECTION yang diminta.

iUsage

Menentukan jenis data yang terkandung dalam anggota array bmiColors dari struktur BITMAPINFO yang diacu oleh pbmi (baik indeks palet logis atau nilai RGB harfiah). Nilai berikut ditentukan.

(DIB_PAL_COLORS)

Anggota bmiColors adalah array indeks 16-bit ke dalam palet logis konteks perangkat yang ditentukan oleh hdc.

(DIB_RGB_COLORS)

Struktur BITMAPINFO berisi array nilai RGB harfiah.

ppvBits

Arahkan ke penunjuk ke data DIBSECTION yang dibuat.

hSectionApp

Dicadangkan. Harus NULL.

dwOffset

Nilai kembali

Jika berhasil, fungsi ini mengembalikan handel ke bitmap yang mewakili DIBSECTION; jika tidak, ia mengembalikan NULL.

Keterangan

Memanggil fungsi ini memastikan palet identitas, dan tidak ada konversi palet saat IDirectDrawSurface7::Blt atau StretchBlt dipanggil.

Aplikasi disarankan untuk menggunakan IDirectDrawSurface7, yang dapat membuat permukaan palet identitas 8-bit-per-piksel dengan cara yang independen dari sistem operasi.

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 ddrawgdi.h

Lihat juga

Dukungan Klien Tingkat Rendah Grafis