SetWindowDisplayAffinity 함수(winuser.h)

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

구문

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

매개 변수

[in] hWnd

형식: HWND

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

[in] dwAffinity

형식:DWORD

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

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

반환 값

형식: BOOL

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

설명

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

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

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

요구 사항

추가 정보

SetWindowDisplayAffinity, Windows