DwmSetWindowAttribute 関数 (dwmapi.h)

デスクトップ ウィンドウ マネージャー (DWM) のクライアント以外のレンダリング属性の値をウィンドウに設定します。 プログラミング ガイダンスとコード例については、「クライアント領域以外のレンダリングの制御」を参照してください。

構文

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 属性を使用し、目的の値を設定する必要があります。 詳細とコード例については、「クライアント領域以外のレンダリングの制御」を参照してください。

必要条件

関連項目

• DwmGetWindowAttribute 関数の
• DWM コンポジション を有効にして制御する