Share via

Fungsi GdiFlush (wingdi.h)

  • Artikel

Fungsi GdiFlush membersihkan batch alur panggilan saat ini.

Sintaks

BOOL GdiFlush();

Mengembalikan nilai

Jika semua fungsi dalam batch saat ini berhasil, nilai yang dikembalikan bukan nol.

Jika tidak semua fungsi dalam batch saat ini berhasil, nilai yang dikembalikan adalah nol, menunjukkan bahwa setidaknya satu fungsi mengembalikan kesalahan.

Keterangan

Batching meningkatkan performa menggambar dengan meminimalkan jumlah waktu yang diperlukan untuk memanggil fungsi gambar GDI yang mengembalikan nilai Boolean. Sistem mengakumulasi parameter untuk panggilan ke fungsi-fungsi ini dalam batch saat ini dan kemudian memanggil fungsi ketika batch dibersihkan dengan salah satu cara berikut:

  • Memanggil fungsi GdiFlush .
  • Mencapai atau melebihi batas batch yang ditetapkan oleh fungsi GdiSetBatchLimit .
  • Mengisi buffer batching.
  • Memanggil fungsi GDI apa pun yang tidak mengembalikan nilai Boolean.
Nilai yang dikembalikan untuk GdiFlush hanya berlaku untuk fungsi dalam batch pada saat GdiFlush dipanggil. Kesalahan yang terjadi ketika batch dibersihkan dengan cara lain tidak pernah dilaporkan.

Fungsi GdiGetBatchLimit mengembalikan batas batch.

Catatan Batas batch dipertahankan untuk setiap utas secara terpisah. Untuk sepenuhnya menonaktifkan batching, panggil GdiSetBatchLimit (1) selama inisialisasi setiap utas.
 
Aplikasi harus memanggil GdiFlush sebelum utas hilang jika ada kemungkinan bahwa ada panggilan fungsi yang tertunda dalam antrean batch grafis. Sistem tidak menjalankan fungsi batch tersebut ketika utas hilang.

Aplikasi multithread yang menserialisasikan akses ke objek GDI dengan mutex harus memastikan pembersihan antrean batch GDI dengan memanggil GdiFlush saat setiap utas merilis kepemilikan objek GDI. Ini mencegah tabrakan objek GDI (konteks perangkat, metafil, dan sebagainya).

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 (sertakan Windows.h)
Pustaka Gdi32.lib
DLL Gdi32.dll

Lihat juga

GdiGetBatchLimit

GdiSetBatchLimit

Fungsi Melukis dan Menggambar

Gambaran Umum Melukis dan Menggambar