Fungsi DdResetVisrgn (ddrawgdi.h)

[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.]

Pembungkus untuk fungsi NtGdiDdResetVisrgn dan memungkinkan informasi mode pengguna yang tepat waktu pada wilayah kliping untuk windows di desktop.

GdiEntry6 didefinisikan sebagai alias untuk fungsi ini.

Sintaks

BOOL DdResetVisrgn(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  HWND                      hWnd
);

Parameter

pSurfaceLocal

Arahkan ke objek mode pengguna dari permukaan apa pun milik perangkat DirectDraw yang klipingnya akan direset. Lihat dokumentasi DDK untuk detailnya.

hWnd

Dicadangkan.

Mengembalikan nilai

Jika berhasil, fungsi ini mengembalikan TRUE; jika tidak, ia mengembalikan FALSE.

Keterangan

Kliping dapat berubah secara asinkron dari sudut pandang utas mode pengguna. Bagian mode kernel DirectDraw dan Windows Graphics Device Interface (GDI) mempertahankan penghitung yang bertahap setiap kali daftar kliping untuk seluruh desktop berubah. Panggilan ke fungsi ini merekam penghitung ini dengan setiap permukaan utama DirectDraw yang ada pada sistem.

Di lain waktu ketika salah satu permukaan utama ini dimodifikasi oleh IDirectDrawSurface7::Blt atau IDirectDrawSurface7::Lock operation (lihat dokumentasi DDK), penghitung yang dicatat dengan permukaan dibandingkan dengan penghitung global. Jika nilai-nilai ini berbeda, kode kesalahan DDERR_VISRGNCHANGED dikembalikan ke kode mode pengguna. Kode mode pengguna kemudian akan mengkueri ulang kliping saat ini untuk desktop, memanggil NtGdiDdResetVisrgn, dan mencoba kembali IDirectDrawSurface7::Blt yang diterapkan ke permukaan utama, sehubungan dengan kliping baru. Akhirnya, kliping yang diambil sampelnya oleh kode mode pengguna akan sama dengan kliping saat ini yang dimiliki oleh mode kernel, dan IDirectDrawSurface7::Blt akan diizinkan untuk melanjutkan.

Aplikasi disarankan untuk menggunakan antarmuka IDirectDrawClipper atau metode IDirect3DDevice8::P resent untuk menangani perubahan kliping asinkron. Konstruksi ini menerapkan kliping asinkron dengan cara otomatis dan sistem operasi-independen.

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