Fungsi SetWindowDisplayAffinity (winuser.h)
Menentukan di mana isi jendela dapat ditampilkan.
Sintaks
BOOL SetWindowDisplayAffinity(
[in] HWND hWnd,
[in] DWORD dwAffinity
);
Parameter
[in] hWnd
Jenis: HWND
Handel ke jendela tingkat atas. Jendela harus termasuk dalam proses saat ini.
[in] dwAffinity
Jenis: DWORD
Pengaturan afinitas tampilan yang menentukan di mana isi jendela dapat ditampilkan.
Parameter ini bisa menjadi salah satu nilai berikut.
Nilai kembali
Jenis: BOOL
Jika fungsi berhasil, fungsi mengembalikan TRUE; jika tidak, ia mengembalikan FALSE ketika, misalnya, panggilan fungsi dilakukan pada jendela tingkat non atas. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi ini dan GetWindowDisplayAffinity dirancang untuk mendukung fitur perlindungan konten jendela yang baru untuk Windows 7. Fitur ini memungkinkan aplikasi untuk melindungi konten jendela pada layar mereka sendiri agar tidak ditangkap atau disalin melalui serangkaian fitur dan API sistem operasi publik tertentu. Namun, ini hanya berfungsi ketika Desktop Window Manager (DWM) menyusun desktop.
Penting untuk dicatat bahwa tidak seperti fitur keamanan atau implementasi Manajemen Hak Digital (DRM), tidak ada jaminan bahwa menggunakan SetWindowDisplayAffinity dan GetWindowDisplayAffinity, dan fungsi lain yang diperlukan seperti DwmIsCompositionEnabled, akan benar-benar melindungi konten berjendela, misalnya di mana seseorang mengambil foto layar.
Mulai Windows 10 Versi 2004, WDA_EXCLUDEFROMCAPTURE adalah nilai yang didukung. Mengatur afinitas tampilan ke WDA_EXCLUDEFROMCAPTURE pada versi Windows sebelumnya akan berprilaku seolah-olah WDA_MONITOR diterapkan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winuser.h (sertakan Windows.h) |
Pustaka | User32.lib |
DLL | User32.dll |
Set API | ext-ms-win-ntuser-window-l1-1-1 (diperkenalkan dalam Windows 8.1) |