Fungsi SetWindowDisplayAffinity (winuser.h)

Artikel
03/04/2024

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	Makna
WDA_NONE 0x00000000	Tidak memberlakukan batasan di mana jendela dapat ditampilkan.
WDA_MONITOR 0x00000001	Konten jendela hanya ditampilkan pada monitor. Di tempat lain, jendela muncul tanpa konten.
WDA_EXCLUDEFROMCAPTURE 0x00000011	Jendela hanya ditampilkan pada monitor. Di tempat lain, jendela tidak muncul sama sekali. Salah satu penggunaan untuk afinitas ini adalah untuk jendela yang menampilkan kontrol perekaman video, sehingga kontrol tidak disertakan dalam pengambilan. Diperkenalkan dalam versi Windows 10 2004. Lihat komentar tentang kompatibilitas mengenai versi Windows sebelumnya.

Nilai

Makna

WDA_NONE
0x00000000

Tidak memberlakukan batasan di mana jendela dapat ditampilkan.

WDA_MONITOR
0x00000001

Konten jendela hanya ditampilkan pada monitor. Di tempat lain, jendela muncul tanpa konten.

WDA_EXCLUDEFROMCAPTURE
0x00000011

Jendela hanya ditampilkan pada monitor. Di tempat lain, jendela tidak muncul sama sekali.

Salah satu penggunaan untuk afinitas ini adalah untuk jendela yang menampilkan kontrol perekaman video, sehingga kontrol tidak disertakan dalam pengambilan.

Diperkenalkan dalam versi Windows 10 2004. Lihat komentar tentang kompatibilitas mengenai versi Windows sebelumnya.

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)

Lihat juga

SetWindowDisplayAffinity, Windows

Bagikan melalui