DwmEnableComposition 関数 (dwmapi.h)
デスクトップ ウィンドウ マネージャー (DWM) コンポジションを有効または無効にします。
メモこの関数は、Windows 8の時点では非推奨です。 DWM をプログラムで無効にすることはできなくなりました。
構文
HRESULT DwmEnableComposition(
[in] UINT uCompositionAction
);
パラメーター
[in] uCompositionAction
DWM コンポジションを有効にするDWM_EC_ENABLECOMPOSITION。コンポジションを無効にするDWM_EC_DISABLECOMPOSITION。
メモWindows 8時点では、この関数を DWM_EC_DISABLECOMPOSITION で呼び出しても効果はありません。 ただし、関数は引き続き成功コードを返します。
戻り値
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
注釈
DWM コンポジションを無効にすると、デスクトップ全体で無効になります。 構成を無効にしたすべてのプロセスが DwmEnableComposition を呼び出して有効にするか、終了すると、DWM コンポジションが自動的に有効になります。 DWM コンポジションが有効または無効になると、WM_DWMCOMPOSITIONCHANGED通知が送信されます。
例
次のコード例では、DWM コンポジションを無効にします。
...
HRESULT hr = S_OK;
// Disable DWM Composition
hr = DwmEnableComposition(DWM_EC_DISABLECOMPOSITION);
if (SUCCEEDED(hr))
{
// ...
}
...
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dwmapi.h |
| Library | Dwmapi.lib |
| [DLL] | Dwmapi.dll |