Fungsi GdiSetBatchLimit (wingdi.h)

Fungsi GdiSetBatchLimit mengatur jumlah maksimum panggilan fungsi yang dapat diakumulasikan dalam batch alur panggilan saat ini. Sistem membersihkan batch saat ini setiap kali batas ini terlampaui.

Sintaks

DWORD GdiSetBatchLimit(
  [in] DWORD dw
);

Parameter

[in] dw

Menentukan batas batch yang akan ditetapkan. Nilai 0 menetapkan batas default. Nilai 1 menonaktifkan batching.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah batas batch sebelumnya.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Hanya fungsi gambar GDI yang mengembalikan nilai Boolean yang dapat diakumulasikan dalam batch saat ini; panggilan ke fungsi GDI lainnya segera menghapus batch saat ini. Melebihi batas batch atau memanggil fungsi GdiFlush juga membersihkan batch saat ini.

Ketika sistem mengakumulasi panggilan fungsi, fungsi mengembalikan TRUE untuk menunjukkan bahwa itu ada dalam batch. Ketika sistem membersihkan batch saat ini dan menjalankan fungsi untuk kedua kalinya, nilai yang dikembalikan adalah TRUE atau FALSE, tergantung pada apakah fungsi berhasil. Nilai pengembalian kedua ini dilaporkan hanya jika GdiFlush digunakan untuk membersihkan batch.

Catatan Batas batch dipertahankan untuk setiap utas secara terpisah. Untuk menonaktifkan batching sepenuhnya, panggil GdiSetBatchLimit (1) selama inisialisasi setiap utas.
 

Persyaratan

   
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

GdiFlush

GdiGetBatchLimit

Fungsi Melukis dan Menggambar

Gambaran Umum Melukis dan Menggambar