Share via

DwmSetWindowAttribute 함수(dwmapi.h)

  • 아티클

창에 대한 클라이언트가 아닌 렌더링 특성인 DWM(Desktop Window Manager) 값을 설정합니다. 프로그래밍 지침 및 코드 예제는 비 클라이언트 지역 렌더링 제어를 참조하세요.

구문

HRESULT DwmSetWindowAttribute(
       HWND    hwnd,
       DWORD   dwAttribute,
  [in] LPCVOID pvAttribute,
       DWORD   cbAttribute
);

매개 변수

hwnd

특성 값을 설정할 창에 대한 핸들입니다.

dwAttribute

DWMWINDOWATTRIBUTE 열거형 값으로 지정된 설정할 값을 설명하는 플래그입니다. 이 매개 변수는 설정할 특성을 지정하고 pvAttribute 매개 변수는 특성 값이 포함된 개체를 가리킵니다.

[in] pvAttribute

설정할 특성 값을 포함하는 개체에 대한 포인터입니다. 값 집합의 형식은 dwAttribute 매개 변수의 값에 따라 달라집니다. DWMWINDOWATTRIBUTE 열거형 항목은 각 플래그의 행에서 pvAttribute 매개 변수에서 포인터를 전달해야 하는 값의 형식을 나타냅니다.

cbAttribute

pvAttribute 매개 변수를 통해 설정되는 특성 값의 크기(바이트)입니다. 값 집합의 형식과 크기(바이트)는 dwAttribute 매개 변수의 값에 따라 달라집니다.

반환 값

형식: HRESULT

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

데스크톱 컴퍼지션을 사용하지 않도록 설정한 경우(Windows 7 이하) 이 함수는 DWM_E_COMPOSITIONDISABLED 반환합니다.

설명

dwAttribute 매개 변수가 DWMWA_NCRENDERING_ENABLED 설정된 상태에서 이 함수를 호출하는 것은 유효하지 않습니다. 비 클라이언트 렌더링을 사용하거나 사용하지 않도록 설정하려면 DWMWA_NCRENDERING_POLICY 특성을 사용하고 원하는 값을 설정해야 합니다. 자세한 정보 및 코드 예제는 비 클라이언트 지역 렌더링 제어를 참조하세요.

요구 사항

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

추가 정보