dwmSetWindowAttribute 函数 (dwmapi.h)

设置桌面窗口管理器的值 (DWM) 窗口的非客户端呈现属性。有关编程指南和代码示例，请参阅控制非客户端区域呈现。

语法

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 属性，并设置所需的值。有关详细信息和代码示例，请参阅控制非客户端区域呈现。