SetWindowDisplayAffinity 함수(winuser.h)

창의 내용을 표시할 수 있는 위치를 지정합니다.

구문

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

매개 변수

[in] hWnd

형식: HWND

최상위 창에 대한 핸들입니다. 창은 현재 프로세스에 속해야 합니다.

[in] dwAffinity

형식:DWORD

창의 내용을 표시할 수 있는 위치를 지정하는 표시 선호도 설정입니다.

이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
WDA_NONE 0x00000000	창을 표시할 수 있는 위치에 제한을 두지 않습니다.
WDA_MONITOR 0x00000001	창 콘텐츠는 모니터에만 표시됩니다. 다른 곳에서는 콘텐츠가 없는 창이 나타납니다.
WDA_EXCLUDEFROMCAPTURE 0x00000011	창은 모니터에만 표시됩니다. 다른 곳에서는 창이 전혀 표시되지 않습니다. 이 선호도의 한 가지 용도는 비디오 녹화 컨트롤을 표시하는 창에서 컨트롤이 캡처에 포함되지 않도록 하는 것입니다. Windows 10 버전 2004에 도입되었습니다. 이전 버전의 Windows와 관련된 호환성에 대한 설명을 참조하세요.

반환 값

형식: BOOL

함수가 성공하면 TRUE를 반환합니다. 그렇지 않으면 함수 호출이 최상위가 아닌 창에서 수행되는 경우 FALSE 를 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수와 GetWindowDisplayAffinity 는 Windows 7에 새로운 창 콘텐츠 보호 기능을 지원하도록 설계되었습니다. 이 기능을 사용하면 애플리케이션이 특정 공용 운영 체제 기능 및 API 집합을 통해 자체 화면 창 콘텐츠가 캡처되거나 복사되지 않도록 보호할 수 있습니다. 그러나 DWM(데스크톱 창 관리자)이 데스크톱을 구성하는 경우에만 작동합니다.

보안 기능이나 DRM(디지털 권한 관리)의 구현과 달리 SetWindowDisplayAffinity 및 GetWindowDisplayAffinity 및 DwmIsCompositionEnabled와 같은 기타 필요한 기능을 사용하면 창이 있는 콘텐츠(예: 누군가가 화면 사진을 찍는 경우)를 엄격하게 보호한다는 보장은 없습니다.

Windows 10 버전 2004부터 WDA_EXCLUDEFROMCAPTURE 지원되는 값입니다. 이전 버전의 Windows에서 디스플레이 선호도를 WDA_EXCLUDEFROMCAPTURE 설정하면 WDA_MONITOR 적용된 것처럼 동작합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-window-l1-1-1(Windows 8.1 소개)

추가 정보

SetWindowDisplayAffinity, Windows