SetWindowDisplayAffinity, fonction (winuser.h)

Spécifie où le contenu de la fenêtre peut être affiché.

Syntaxe

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

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre de niveau supérieur. La fenêtre doit appartenir au processus actuel.

[in] dwAffinity

Type : DWORD

Paramètre d’affinité d’affichage qui spécifie où le contenu de la fenêtre peut être affiché.

Ce paramètre peut prendre les valeurs suivantes.

Valeur retournée

Type : BOOL

Si la fonction réussit, elle retourne TRUE ; sinon, elle retourne FALSE lorsque, par exemple, l’appel de fonction est effectué sur une fenêtre de niveau non supérieur. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette fonction et GetWindowDisplayAffinity sont conçus pour prendre en charge la fonctionnalité de protection du contenu des fenêtres qui est nouvelle dans Windows 7. Cette fonctionnalité permet aux applications de protéger leur propre contenu de fenêtre à l’écran contre la capture ou la copie via un ensemble spécifique de fonctionnalités et d’API du système d’exploitation public. Toutefois, elle fonctionne uniquement lorsque le Gestionnaire de fenêtres du bureau (DWM) compose le bureau.

Il est important de noter que contrairement à une fonctionnalité de sécurité ou à une implémentation de la gestion des droits numériques (DRM), il n’existe aucune garantie que l’utilisation de SetWindowDisplayAffinity et GetWindowDisplayAffinity, et d’autres fonctions nécessaires telles que DwmIsCompositionEnabled, protégera strictement le contenu fenêtré, par exemple lorsque quelqu’un prend une photo de l’écran.

À compter de Windows 10 version 2004, WDA_EXCLUDEFROMCAPTURE est une valeur prise en charge. La définition de l’affinité d’affichage sur WDA_EXCLUDEFROMCAPTURE sur la version précédente de Windows se comporte comme si WDA_MONITOR était appliqué.

Configuration requise

Voir aussi

SetWindowDisplayAffinity, Windows