EnumDisplaySettings 関数は、ディスプレイ デバイスのグラフィックス モードの 1 つに関する情報を取得します。 ディスプレイ デバイスのすべてのグラフィックス モードの情報を取得するには、この関数を一連の呼び出しを行います。
注意 Windows 8 以降を対象とするように設計したアプリでは、1 ピクセルあたり 32 ビット未満 (bpp) の表示モードのクエリや設定ができなくなります。これらの操作は失敗します。 これらのアプリには、Windows 8 を対象とする 互換性マニフェスト があります。 Windows 8 では、Windows 8 マニフェストなしでビルドされたデスクトップ アプリの 8 ビットと 16 ビットのカラー モードが引き続きサポートされます。Windows 8 はこれらのモードをエミュレートしますが、32 ビット カラー モードで実行されます。
構文
BOOL EnumDisplaySettingsW(
[in] LPCWSTR lpszDeviceName,
[in] DWORD iModeNum,
[out] DEVMODEW *lpDevMode
);
パラメーター
[in] lpszDeviceName
関数が情報を取得するグラフィックス モードに関する表示デバイスを指定する null で終わる文字列へのポインター。
このパラメーターは、NULL または
[in] iModeNum
取得する情報の種類。 この値には、グラフィックス モードのインデックスまたは次のいずれかの値を指定できます。
| 価値 | 意味 |
|---|---|
|
ディスプレイ デバイスの現在の設定を取得します。 |
|
レジストリに現在格納されているディスプレイ デバイスの設定を取得します。 |
グラフィックス モードのインデックスは 0 から始まります。 ディスプレイ デバイスのすべてのグラフィックス モードの情報を取得するには、次のように、
[out] lpDevMode
指定したグラフィックス モードに関する情報を関数が格納する DEVMODE 構造体へのポインター。 EnumDisplaySettings
EnumDisplaySettings 関数は、次の 5 つの DEVMODE メンバーの値を設定します。
- dmBitsPerPel を
する - dmPelsWidth を
する - dmPelsHeight
- dmDisplayFlags を
する - dmDisplayFrequency を
する
戻り値
関数が成功した場合、戻り値は 0 以外です。
関数が失敗した場合、戻り値は 0 です。
備考
iModeNum
DPI 仮想化
この API は DPI 仮想化には参加しません。 指定された出力は常に物理ピクセルの観点からであり、呼び出し元のコンテキストには関連しません。手記
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして EnumDisplaySettings を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winuser.h (Windows.h を含む) |
| ライブラリ | User32.lib |
| DLL | User32.dll |
| API セットの | ext-ms-win-ntuser-sysparams-ext-l1-1-0 (Windows 8 で導入) |
関連項目
CreateDC の
CreateDesktop の
DEVMODE の
EnumDisplayDevices の