Función SetWindowDisplayAffinity (winuser.h)

  • Artículo

Especifica dónde se puede mostrar el contenido de la ventana.

Sintaxis

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

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana de nivel superior. La ventana debe pertenecer al proceso actual.

[in] dwAffinity

Tipo: DWORD

La configuración de afinidad para mostrar que especifica dónde se puede mostrar el contenido de la ventana.

Este parámetro puede ser uno de los valores siguientes.

Valor Significado
WDA_NONE
0x00000000
 No impone ninguna restricción sobre dónde se puede mostrar la ventana.
WDA_MONITOR
0x00000001
 El contenido de la ventana solo se muestra en un monitor. En cualquier otro lugar, la ventana aparece sin contenido.
WDA_EXCLUDEFROMCAPTURE
0x00000011
 La ventana solo se muestra en un monitor. En cualquier otro lugar, la ventana no aparece en absoluto.

Un uso de esta afinidad es para ventanas que muestran controles de grabación de vídeo, de modo que los controles no se incluyan en la captura.

Introducido en Windows 10 versión 2004. Consulta los comentarios sobre la compatibilidad con versiones anteriores de Windows.

Valor devuelto

Tipo: BOOL

Si la función se ejecuta correctamente, devuelve TRUE; de lo contrario, devuelve FALSE cuando, por ejemplo, la llamada de función se realiza en una ventana que no es de nivel superior. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Esta función y GetWindowDisplayAffinity están diseñadas para admitir la característica de protección de contenido de ventana que es nueva en Windows 7. Esta característica permite a las aplicaciones proteger su propio contenido de ventana en pantalla de la captura o copiación 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, por ejemplo, donde alguien toma una fotografía de la pantalla.

A partir de Windows 10 versión 2004, WDA_EXCLUDEFROMCAPTURE es un valor admitido. Si se establece la afinidad de visualización en WDA_EXCLUDEFROMCAPTURE en la versión anterior de Windows, se comportará como si se aplicara WDA_MONITOR.

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

SetWindowDisplayAffinity, Windows