DwmIsCompositionEnabled 関数 (dwmapi.h)

  • [アーティクル]

デスクトップ ウィンドウ マネージャー (DWM) コンポジションが有効かどうかを示す値を取得します。 Windows 7 以前を実行しているマシン上のアプリケーションは、 WM_DWMCOMPOSITIONCHANGED 通知を処理することで、コンポジション状態の変更をリッスンできます。

構文

HRESULT DwmIsCompositionEnabled(
  [out] BOOL *pfEnabled
);

パラメーター

[out] pfEnabled

DWM コンポジションが有効になっている場合に、この関数が正常に返されるときに TRUE を 受け取る値へのポインター。それ以外の場合は FALSE。

メモWindows 8の時点では、DWM コンポジションは常に有効になっています。 アプリがマニフェストで互換性Windows 8宣言した場合、この関数は pfEnabled を介して TRUE の値を受け取ります。 このようなマニフェスト エントリが見つからない場合、Windows 8互換性は想定されず、この関数は pfEnabled を介して FALSE の値を受け取ります。 これは、高コントラスト モードがオフであることを意味する TRUE の値を解釈する古いプログラムが、イメージのレンダリングに関する正しい決定を引き続き行えるようにするために行われます。 (これは不適切な方法であることに注意してください。ハイ コントラスト モードの状態を判断するには、SPI_GETHIGHCONTRAST フラグと共に SystemParametersInfo 関数を使用する必要があります)。
 
詳細については、「 ハイ コントラスト テーマのサポート」を参照してください。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー dwmapi.h
Library Dwmapi.lib
[DLL] Dwmapi.dll