Struktur WNDOBJ (winddi.h)

Artikel
03/13/2024

Struktur WNDOBJ memungkinkan driver untuk melacak perubahan posisi, ukuran, dan wilayah klien yang terlihat dari jendela.

Sintaks

typedef struct _WNDOBJ {
  CLIPOBJ coClient;
  PVOID   pvConsumer;
  RECTL   rclClient;
  SURFOBJ *psoOwner;
} WNDOBJ, *PWNDOBJ;

Anggota

coClient

Menentukan struktur CLIPOBJ yang menjelaskan wilayah klien jendela. Jika iDComplexity DC_RECT dan tepi kiri di rclBounds lebih besar dari atau sama dengan tepi kanan, atau tepi atas lebih besar dari atau sama dengan tepi bawah, wilayah klien tidak terlihat.

pvConsumer

Penunjuk ke nilai yang ditentukan driver yang mengidentifikasi struktur WNDOBJ khusus ini. Nilai ini dapat diatur dengan memanggil fungsi WNDOBJ_vSetConsumer .

rclClient

Menentukan struktur RECTL yang menjelaskan area klien jendela dalam koordinat layar. Persegi panjang ini eksklusif kanan bawah, yang berarti bahwa tepi bawah dan kanan wilayah ini tidak disertakan.

psoOwner

Pointer ke struktur SURFOBJ yang diteruskan ke EngCreateWnd ketika WNDOBJ ini dibuat.

Keterangan

Wilayah klien yang terlihat dapat dijumlahkan dengan memanggil fungsi WNDOBJ_cEnumStart dan WNDOBJ_bEnum .

Driver dapat mengaitkan datanya sendiri dengan WNDOBJ dengan memanggil fungsi WNDOBJ_vSetConsumer .

Sebagai akselerator, pengemudi dapat mengakses anggota publik WNDOBJ. Anggota publik ini dijamin tetap tidak berubah hanya dalam konteks rutinitas panggilan balik driver yang disediakan untuk GDI dalam fungsi EngCreateWnd , atau fungsi di mana WNDOBJ diberikan.

Driver harus menggunakan SURFOBJ di mana psoOwner menunjuk untuk mengambil status khusus driver yang relevan dengan WNDOBJ, seperti handel PDEV driver, daripada mempertahankan variabel global.