Función GetWindowDisplayAffinity (winuser.h)

Recupera la configuración de afinidad de visualización actual, de cualquier proceso, para una ventana determinada.

Sintaxis

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

Parámetros

[in] hWnd

Tipo: HWND

Un identificador de la ventana.

[out] pdwAffinity

Tipo: DWORD*

Puntero a una variable que recibe la configuración de afinidad para mostrar. Consulte SetWindowDisplayAffinity para obtener una lista de la configuración de afinidad y sus significados.

Valor devuelto

Tipo: BOOL

Esta función solo se realiza correctamente cuando la ventana está superpuesta y el Administrador de Windows de escritorio está redactando el escritorio. Si esta función se ejecuta correctamente, devuelve TRUE; de lo contrario, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Esta función y SetWindowDisplayAffinity están diseñadas para admitir la característica de protección de contenido de ventana única para Windows 7. Esta característica permite a las aplicaciones proteger su propio contenido de ventana en pantalla de ser capturados o copiados a través de un conjunto específico de características y API del sistema operativo público. Sin embargo, solo funciona cuando el Administrador de ventanas de escritorio (DWM) está redactando el escritorio.

Es importante tener en cuenta que, a diferencia de una característica de seguridad o una implementación de Digital Rights Management (DRM), no hay ninguna garantía de que el uso de SetWindowDisplayAffinity y GetWindowDisplayAffinity, y otras funciones necesarias, como DwmIsCompositionEnabled, protegerán estrictamente el contenido en ventana, como en el caso de que alguien tome una fotografía de la pantalla.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-1 (introducido en Windows 8.1)

Consulte también

Conceptual

Windows