DwmEnableComposition 関数 (dwmapi.h)

  • [アーティクル]

デスクトップ ウィンドウ マネージャー (DWM) コンポジションを有効または無効にします。

メモこの関数は、Windows 8の時点では非推奨です。 DWM をプログラムで無効にすることはできなくなりました。
 

構文

HRESULT DwmEnableComposition(
  UINT uCompositionAction
);

パラメーター

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

こちらもご覧ください

Enable and Control DWM Composition (DWM の構成の有効化と制御)