次の方法で共有

ChangeDisplaySettingsA 関数 (winuser.h)

  • [アーティクル]

ChangeDisplaySettings 関数は、既定のディスプレイ デバイスの設定を指定されたグラフィックス モードに変更します。

指定したディスプレイ デバイスの設定を変更するには、ChangeDisplaySettingsEx 関数を使用します。

注意 Windows 8 以降を対象とするように設計したアプリでは、1 ピクセルあたり 32 ビット未満 (bpp) の表示モードのクエリや設定ができなくなります。これらの操作は失敗します。 これらのアプリには、Windows 8 を対象とする 互換性マニフェスト があります。 Windows 8 では、Windows 8 マニフェストなしでビルドされたデスクトップ アプリの 8 ビットと 16 ビットのカラー モードが引き続きサポートされます。Windows 8 はこれらのモードをエミュレートしますが、32 ビット カラー モードで実行されます。
 

構文

LONG ChangeDisplaySettingsA(
  [in] DEVMODEA *lpDevMode,
  [in] DWORD    dwFlags
);

パラメーター

[in] lpDevMode

新しいグラフィックス モードを記述する DEVMODE 構造体へのポインター。 lpDevMode が NULL場合、レジストリ内の現在のすべての値が表示設定に使用されます。 lpDevMode パラメーター NULL を渡し、dwFlags パラメーターに 0 を渡すことが、動的モードの変更後に既定のモードに戻る最も簡単な方法です。

DEVMODE の dmSize メンバーは、DEVMODE 構造体のサイズ (バイト単位) に初期化する必要があります。 DEVMODE の dmDriverExtra メンバーは、DEVMODE 構造体に続くプライベート ドライバー データのバイト数を示すために初期化する必要があります。 さらに、DEVMODE 構造体の次のメンバーの一部またはすべてを使用できます。

メンバー 意味
dmBitsPerPel を する ピクセルあたりのビット数
dmPelsWidth を する ピクセル幅
dmPelsHeight ピクセルの高さ
dmDisplayFlags を する モード フラグ
dmDisplayFrequency を する モードの頻度
dmPosition を する マルチモニター構成でのデバイスの位置。
 

上記の 1 つ以上の DEVMODE メンバーを使用するだけでなく、表示設定を変更するには、dmFields メンバーに次の値の 1 つ以上を設定する必要があります。

価値 意味
DM_BITSPERPEL dmBitsPerPel 値を使用します。
DM_PELSWIDTH dmPelsWidth 値を使用します。
DM_PELSHEIGHT dmPelsHeight 値を使用します。
DM_DISPLAYFLAGS dmDisplayFlags 値を使用します。
DM_DISPLAYFREQUENCY dmDisplayFrequency 値を使用します。
DM_POSITION dmPosition 値を使用します。

[in] dwFlags

グラフィックス モードを変更する方法を示します。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
0
 現在の画面のグラフィックス モードは動的に変更されます。
CDS_FULLSCREEN
 モードは本質的に一時的なものです。

別のデスクトップとの間で切り替える場合、このモードはリセットされません。
CDS_GLOBAL
 設定は、コンピューター上のすべてのユーザーに影響を与えるように、グローバル設定領域に保存されます。 それ以外の場合は、ユーザーの設定のみが変更されます。 このフラグは、CDS_UPDATEREGISTRY フラグで指定されている場合にのみ有効です。
CDS_NORESET
 設定はレジストリに保存されますが、有効になりません。 このフラグは、CDS_UPDATEREGISTRY フラグで指定されている場合にのみ有効です。
CDS_RESET
 要求された設定が現在の設定と同じ場合でも、設定を変更する必要があります。
CDS_SET_PRIMARY
 このデバイスがプライマリ デバイスになります。
CDS_TEST
 システムは、要求されたグラフィックス モードを設定できるかどうかをテストします。
CDS_UPDATEREGISTRY
 現在の画面のグラフィックス モードは動的に変更され、グラフィックス モードはレジストリで更新されます。 モード情報は USER プロファイルに格納されます。
 

CDS_TESTを指定すると、システムがそのグラフィックス モードに変更されることなく、アプリケーションで実際に有効なグラフィックス モードを判断できます。

CDS_UPDATEREGISTRYを指定し、グラフィックス モードを動的に変更できる場合は、情報がレジストリに格納され、DISP_CHANGE_SUCCESSFULが返されます。 グラフィックス モードを動的に変更できない場合は、情報がレジストリに格納され、DISP_CHANGE_RESTARTが返されます。

CDS_UPDATEREGISTRYを指定し、情報をレジストリに格納できなかった場合、グラフィックス モードは変更されず、DISP_CHANGE_NOTUPDATEDが返されます。

戻り値

ChangeDisplaySettings 関数は、次のいずれかの値を返します。

リターン コード 形容
DISP_CHANGE_SUCCESSFUL
 設定の変更が成功しました。
DISP_CHANGE_BADDUALVIEW
 システムが DualView に対応しているため、設定の変更は失敗しました。
DISP_CHANGE_BADFLAGS
 無効なフラグのセットが渡されました。
DISP_CHANGE_BADMODE
 グラフィックス モードはサポートされていません。
DISP_CHANGE_BADPARAM
 無効なパラメーターが渡されました。 これには、無効なフラグやフラグの組み合わせを含めることができます。
DISP_CHANGE_FAILED
 ディスプレイ ドライバーが指定されたグラフィックス モードに失敗しました。
DISP_CHANGE_NOTUPDATED
 レジストリに設定を書き込むことができません。
DISP_CHANGE_RESTART
 グラフィックス モードを機能させるには、コンピューターを再起動する必要があります。

備考

ChangeDisplaySettings に渡される DEVMODE 構造体が有効であり、ディスプレイ ドライバーでサポートされている値のみが含まれていることを確認するには、EnumDisplaySettings 関数によって返される DEVMODE を使用します。

表示モードが動的に変更されると、WM_DISPLAYCHANGE メッセージは、次のメッセージ パラメーターを使用して実行中のすべてのアプリケーションに送信されます。

パラメーター 意味
wParam ピクセルあたりの新しいビット数
LOWORD(lParam) 新しいピクセル幅
HIWORD(lParam) 新しいピクセルの高さ
 

DPI 仮想化

この API は DPI 仮想化には参加しません。 指定された入力は常に物理ピクセルの観点からであり、呼び出し元のコンテキストには関連しません。

手記

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ChangeDisplaySettings を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winuser.h (Windows.h を含む)
ライブラリ User32.lib
DLL User32.dll
API セットの ext-ms-win-ntuser-sysparams-ext-l1-1-1 (Windows 10 バージョン 10.0.14393 で導入)

関連項目

ChangeDisplaySettingsEx

CreateDC の

DEVMODE の

デバイス コンテキスト関数の

デバイス コンテキストの概要

EnumDisplayDevices の

EnumDisplaySettings の

WM_DISPLAYCHANGE