DwmIsCompositionEnabled 함수(dwmapi.h)

DWM(데스크톱 창 관리자) 컴퍼지션이 사용되는지 여부를 나타내는 값을 가져옵니다. Windows 7 이하를 실행하는 컴퓨터의 애플리케이션은 WM_DWMCOMPOSITIONCHANGED 알림을 처리하여 컴퍼지션 상태 변경을 수신 대기할 수 있습니다.

구문

HRESULT DwmIsCompositionEnabled(
  [out] BOOL *pfEnabled
);

매개 변수

[out] pfEnabled

이 함수가 성공적으로 반환될 때 DWM 컴퍼지션이 사용하도록 설정된 경우 TRUE 를 수신하는 값에 대한 포인터입니다. 그렇지 않으면 FALSE입니다.

참고 Windows 8 기준으로 DWM 컴퍼지션은 항상 사용하도록 설정됩니다. 앱이 매니페스트에서 Windows 8 호환성을 선언하는 경우 이 함수는 pfEnabled를 통해 TRUE 값을 받습니다. 이러한 매니페스트 항목을 찾을 수 없는 경우 Windows 8 호환성이 가정되지 않으며 이 함수는 pfEnabled를 통해 FALSE 값을 받습니다. 이렇게 하면 고대비 모드가 꺼져 있음을 암시하기 위해 TRUE 값을 해석하는 이전 프로그램이 이미지 렌더링에 대한 올바른 결정을 계속 내릴 수 있습니다. (이는 잘못된 사례입니다. 고대비 모드의 상태를 확인하려면 SPI_GETHIGHCONTRAST 플래그와 함께 SystemParametersInfo 함수를 사용해야 합니다.)

 

자세한 내용은 고대비 테마 지원을 참조하세요.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dwmapi.h
라이브러리	Dwmapi.lib
DLL	Dwmapi.dll