Função GetWindowDisplayAffinity (winuser.h)

  • Artigo

Recupera a configuração de afinidade de exibição atual, de qualquer processo, para uma determinada janela.

Sintaxe

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

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela.

[out] pdwAffinity

Tipo: DWORD*

Um ponteiro para uma variável que recebe a configuração de afinidade de exibição. Consulte SetWindowDisplayAffinity para obter uma lista de configurações de afinidade e seus significados.

Retornar valor

Tipo: BOOL

Essa função só é bem-sucedida quando a janela está em camadas e o Gerenciador de Área de Trabalho do Windows está redigindo a área de trabalho. Se essa função for bem-sucedida, ela retornará TRUE; caso contrário, retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função e SetWindowDisplayAffinity foram projetadas para dar suporte ao recurso de proteção de conteúdo de janela exclusivo para o Windows 7. Esse recurso permite que os aplicativos protejam seu próprio conteúdo de janela na tela de serem capturados ou copiados por meio de um conjunto específico de APIs e recursos do sistema operacional público. No entanto, ele funciona somente quando o DWM (Gerenciador de Janelas da Área de Trabalho) está redigindo a área de trabalho.

É importante observar que, ao contrário de um recurso de segurança ou de uma implementação do DRM (Digital Rights Management), não há garantia de que usar SetWindowDisplayAffinity e GetWindowDisplayAffinity e outras funções necessárias, como DwmIsCompositionEnabled, protegerá estritamente o conteúdo em janelas, como no caso em que alguém tira uma foto da tela.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-window-l1-1-1 (introduzido em Windows 8.1)

Confira também

Conceitual

Windows