SetWindowDisplayAffinity-Funktion (winuser.h)

Artikel
08/28/2023

Gibt an, wo der Inhalt des Fensters angezeigt werden kann.

Syntax

BOOL SetWindowDisplayAffinity(
  [in] HWND  hWnd,
  [in] DWORD dwAffinity
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster der obersten Ebene. Das Fenster muss zum aktuellen Prozess gehören.

[in] dwAffinity

Art: DWORD

Die Einstellung für die Anzeigeaffinität, die angibt, wo der Inhalt des Fensters angezeigt werden kann.

Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
WDA_NONE 0x00000000	Erzwingt keine Einschränkungen, wo das Fenster angezeigt werden kann.
WDA_MONITOR 0x00000001	Der Fensterinhalt wird nur auf einem Monitor angezeigt. Überall sonst wird das Fenster ohne Inhalt angezeigt.
WDA_EXCLUDEFROMCAPTURE 0x00000011	Das Fenster wird nur auf einem Monitor angezeigt. Überall sonst wird das Fenster überhaupt nicht angezeigt. Eine Verwendung für diese Affinität ist für Fenster, die Videoaufzeichnungssteuerelemente anzeigen, sodass die Steuerelemente nicht in der Aufnahme enthalten sind. Eingeführt in Windows 10 Version 2004. Weitere Informationen finden Sie unter Hinweise zur Kompatibilität mit früheren Versionen von Windows.

Wert

Bedeutung

WDA_NONE
0x00000000

Erzwingt keine Einschränkungen, wo das Fenster angezeigt werden kann.

WDA_MONITOR
0x00000001

Der Fensterinhalt wird nur auf einem Monitor angezeigt. Überall sonst wird das Fenster ohne Inhalt angezeigt.

WDA_EXCLUDEFROMCAPTURE
0x00000011

Das Fenster wird nur auf einem Monitor angezeigt. Überall sonst wird das Fenster überhaupt nicht angezeigt.

Eine Verwendung für diese Affinität ist für Fenster, die Videoaufzeichnungssteuerelemente anzeigen, sodass die Steuerelemente nicht in der Aufnahme enthalten sind.

Eingeführt in Windows 10 Version 2004. Weitere Informationen finden Sie unter Hinweise zur Kompatibilität mit früheren Versionen von Windows.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück. Andernfalls wird FALSE zurückgegeben, wenn der Funktionsaufruf beispielsweise in einem Fenster der obersten Ebene erfolgt. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion und GetWindowDisplayAffinity sind so konzipiert, dass sie das Feature zum Schutz von Fensterinhalten unterstützen, das in Windows 7 neu ist. Mit diesem Feature können Anwendungen ihre eigenen Inhalte auf dem Bildschirm vor dem Erfassen oder Kopieren durch einen bestimmten Satz von Features und APIs des öffentlichen Betriebssystems schützen. Dies funktioniert jedoch nur, wenn der Desktopfenster-Manager (DWM) den Desktop erstellt.

Es ist wichtig zu beachten, dass im Gegensatz zu einem Sicherheitsfeature oder einer Implementierung von Digital Rights Management (DRM) keine Garantie dafür besteht, dass die Verwendung von SetWindowDisplayAffinity und GetWindowDisplayAffinity und anderen erforderlichen Funktionen wie DwmIsCompositionEnabled inhalte im Fenster streng schützen, z. B. wenn jemand ein Foto vom Bildschirm macht.

Ab Windows 10 Version 2004 ist WDA_EXCLUDEFROMCAPTURE ein unterstützter Wert. Das Festlegen der Anzeigeaffinität auf WDA_EXCLUDEFROMCAPTURE in früheren Windows-Versionen verhält sich so, als ob WDA_MONITOR angewendet würde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-1 (eingeführt in Windows 8.1)

Weitere Informationen

SetWindowDisplayAffinity, Windows

Freigeben über