Fungsi DrvSaveScreenBits (winddi.h)

Artikel
08/27/2023

Fungsi DrvSaveScreenBits menyebabkan driver tampilan menyimpan atau memulihkan persegi panjang tertentu dari gambar yang ditampilkan.

Sintaks

ULONG_PTR DrvSaveScreenBits(
  SURFOBJ   *pso,
  ULONG     iMode,
  ULONG_PTR ident,
  RECTL     *prcl
);

Parameter

pso

Penunjuk ke struktur SURFOBJ yang menggambarkan permukaan.

iMode

Menentukan operasi yang akan dilakukan. Parameter ini bisa menjadi salah satu nilai berikut:

SS_SAVE

Driver harus menyimpan data dari persegi panjang yang ditentukan oleh prcl. Driver bertanggung jawab untuk mengelola data ini dalam memori di luar layarnya. Parameter ident diabaikan.

Setelah berhasil, DrvSaveScreenBits harus mengembalikan pengidentifikasi untuk data yang disimpan. Driver dapat mengembalikan handel atau bahkan penunjuk ke memori di luar layarnya. Fungsi ini mengembalikan nol jika gagal.

SS_RESTORE

Driver harus memulihkan data yang diidentifikasi oleh ident ke rrcl persegi panjang pada layar; artinya, driver harus memulihkan bitmap ke posisi semula. Driver dapat mengasumsikan bahwa persegi panjang di rrtl berukuran sama persis dengan persegi panjang yang disimpan. Data harus dibuang setelah panggilan ini.

DrvSaveScreenBits harus mengembalikan TRUE jika data telah dipulihkan ke tampilan, atau FALSE jika data tidak dapat dipulihkan.

SS_FREE

Data yang diidentifikasi oleh identitas tidak lagi diperlukan dan dapat dibebaskan. Nilai rrtl tidak ditentukan dan tidak boleh digunakan. Driver tidak boleh memulihkan persegi panjang tersimpan ke tampilan.

DrvSaveScreenBits harus mengembalikan TRUE.

ident

Penunjuk ke nilai yang ditentukan driver yang dikembalikan oleh panggilan sebelumnya ke DrvSaveScreenBits jika iMode SS_RESTORE atau SS_FREE. Driver harus mengabaikan parameter ini ketika iMode SS_SAVE.

prcl

Penunjuk ke struktur RECTL yang menentukan bagian layar yang akan disimpan atau dipulihkan.

Nilai kembali

Nilai yang dikembalikan tergantung pada nilai parameter iMode .

Keterangan

Beberapa driver tampilan mungkin dapat memindahkan data ke atau dari memori perangkat di luar layar jauh lebih cepat daripada area yang dapat digambar ulang. Ini mungkin berguna ketika Window Manager harus menampilkan menu atau kotak dialog.

DrvSaveScreenBits bersifat opsional untuk driver tampilan.

Persyaratan

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

Lihat juga

SURFOBJ

Bagikan melalui