다음을 통해 공유

DwmSetWindowAttribute 함수(dwmapi.h)

  • 아티클

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

통사론

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

매개 변수

[in] hwnd

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

[in] dwAttribute

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

[in] pvAttribute

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

[in] 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

참고 항목