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 |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기