GetWindowDisplayAffinity, fonction (winuser.h)

Article
08/27/2023

Récupère le paramètre d’affinité d’affichage actuel, à partir de n’importe quel processus, pour une fenêtre donnée.

Syntaxe

BOOL GetWindowDisplayAffinity(
  [in]  HWND  hWnd,
  [out] DWORD *pdwAffinity
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre.

[out] pdwAffinity

Type : DWORD*

Pointeur vers une variable qui reçoit le paramètre d’affinité d’affichage. Consultez SetWindowDisplayAffinity pour obtenir la liste des paramètres d’affinité et leurs significations.

Valeur retournée

Type : BOOL

Cette fonction réussit uniquement lorsque la fenêtre est en couches et que le Gestionnaire Windows de bureau compose le bureau. Si cette fonction réussit, elle retourne TRUE ; sinon, elle retourne FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette fonction et SetWindowDisplayAffinity sont conçus pour prendre en charge la fonctionnalité de protection du contenu des fenêtres propre à 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, il fonctionne uniquement lorsque le Gestionnaire de fenêtres de 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é, comme dans le cas où quelqu’un prend une photo de l’écran.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-1 (introduit dans Windows 8.1)

Voir aussi

Conceptuel

Windows

Partager via