On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

ChangeDisplaySettings

The ChangeDisplaySettings function changes the display settings to the specified graphics mode.

LONG ChangeDisplaySettings(

LPDEVMODE lpDevMode,
DWORD dwflags
);

Parameters

lpDevMode

Pointer to a DEVMODE structure that describes the graphics mode to switch to. The dmSize member must be initialized to the size, in bytes, of the DEVMODE structure. The following fields in the DEVMODE structure are used:

Member Meaning
dmBitsPerPel Bits per pixel
dmPelsWidth Pixel width
dmPelsHeight Pixel height
dmDisplayFlags Mode flags
dmDisplayFrequency Mode frequency

In addition to setting a value in one or more of the preceding DEVMODE members, you must also set the appropriate flags in the dmFields member. The flags indicate which members of the DEVMODE structure are used for the display settings change. If the appropriate bit is not set in dmFields, the display setting will not be changed. Set one or more of the following flags:

Flag Meaning
DM_BITSPERPEL Use the dmBitsPerPel value.
DM_PELSWIDTH Use the dmPelsWidth value.
DM_PELSHEIGHT Use the dmPelsHeight value.
DM_DISPLAYFLAGS Use the dmDisplayFlags value.
DM_DISPLAYFREQENCY Use the dmDisplayFrequency value.

If lpDevMode is NULL, all the values currently in the registry will be used for the display setting. Passing NULL for the lpDevMode parameter is the easiest way to return to the default mode after a dynamic mode change.

dwflags

Indicates how the graphics mode should be changed. May be one of the following:

Flag Meaning
0 The graphics mode for the current screen will be changed dynamically.
CDS_UPDATEREGISTRY The graphics mode for the current screen will be changed dynamically and the graphics mode will be updated in the registry. The mode information is stored in the USER profile.
CDS_TEST The system tests if the requested graphics mode could be set.

If CDS_UPDATEREGISTRY is specified and it is possible to change the graphics mode dynamically, the information is stored in the registry and DISP_CHANGE_SUCCESSFUL is returned. If it is not possible to change the graphics mode dynamically, the information is stored in the registry and DISP_CHANGE_RESTART is returned.
Windows NT: If the information could not be stored in the registry, the graphics mode is not changed and DISP_CHANGE_NOTUPDATED is returned.
Specifying CDS_TEST allows an application to determine which graphics modes are actually valid, without causing the system to change to that graphics mode.

Return Values

Returns one of the following values:

Value Meaning
DISP_CHANGE_SUCCESSFUL The settings change was successful.
DISP_CHANGE_RESTART The computer must be restarted in order for the graphics mode to work.
DISP_CHANGE_BADFLAGS An invalid set of flags was passed in.
DISP_CHANGE_FAILED The display driver failed the specified graphics mode.
DISP_CHANGE_BADMODE The graphics mode is not supported.
DISP_CHANGE_NOTUPDATED Windows NT only: Unable to write settings to the registry.

Remarks

Using the DEVMODE returned by the EnumDisplaySettings function ensures that the DEVMODE passed to ChangeDisplaySettings is valid and contains only values supported by the display driver.
When the display mode is changed dynamically, the WM_DISPLAYCHANGE message is sent to all running applications with the following message parameters:

Parameters Meaning
wParam New bits per pixel
LOWORD(lParam) New pixel width
HIWORD(lParam) New pixel height

See Also

CreateDC, DEVMODE, EnumDisplaySettings, WM_DISPLAYCHANGE

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

ChangeDisplaySettings

Функция ChangeDisplaySettings изменяет дисплейную обстановку в определенный графический способ.

ДОЛГО (ДЛИНОЙ) ChangeDisplaySettings(

LPDEVMODE lpDevMode, dwflags DWORD
);

Параметры

lpDevMode

Указатель в структуру DEVMODE, которая описывает графический способ, чтобы переключать, чтобы. Член dmSize должен быть инициализирован в размер, в байтах, структуры DEVMODE. Следующие области в структуре DEVMODE использованы:

Член, означающий Биты dmBitsPerPel за Пиксель пикселя dmPelsWidth широтной высоты Способа Пикселя dmPelsHeight Способа флагов dmDisplayFlags частоты dmDisplayFrequency

Дополнительно к установке величины на одном или более из предыдущих участников DEVMODE, Вы должны также установить подходящие флаги на члене dmFields. Флаги указываются, какие участники структуры DEVMODE использованы для дисплейного изменения обстановки. Если подходящий бит не установлен в dmFields, показ, устанавливающий не будет измениться. Установите одно или более из следующего флагов:

Значение Флага
DM_BITSPERPEL Использует величину dmBitsPerPel.
DM_PELSWIDTH Использует величину dmPelsWidth.
DM_PELSHEIGHT Использует величину dmPelsHeight.
DM_DISPLAYFLAGS Использует величину dmDisplayFlags.
DM_DISPLAYFREQENCY Использует величину dmDisplayFrequency.

Если lpDevMode НЕДЕЙСТВИТЕЛЕН, все величины к настоящему времени в регистрации будут использованы для дисплейной установки. Прохождение НЕДЕЙСТВИТЕЛЬНОЕ для параметра lpDevMode - легчайший путь возвращаться во встроенный способ после динамического изменения способа.

dwflags

Указывает как графический способ должен быть изменен. Может быть одним из следующего:

Значение Флага
0 Графический способ для текущего экрана изменится динамически.
CDS_UPDATEREGISTRY графический способ для текущего экрана изменится динамически и графический способ будет скорректирован в регистрации. Информация режима загружена в профиль ПОЛЬЗОВАТЕЛЯ.
CDS_TEST системные тесты если запрошенный графический режим мог бы быть установлен.

Если CDS_UPDATEREGISTRY определен и возможно должно изменять графический режим динамически, информация загружена в регистрацию и DISP_CHANGE_SUCCESSFUL возвращан. Если возможно не должно изменять графический режим динамически, информация загружена в регистрацию и DISP_CHANGE_RESTART возвращан.
Windows NT: Если информация не могла загружана в регистрацию, графический режим не изменен и DISP_CHANGE_NOTUPDATED возвращан.
Определение CDS_TEST позволяет приложение, чтобы определять, что какие графические режимы - действительно правильные, не вызывая систему, чтобы изменять в этот графический режим.

Обратные Величины

Возвращает одно из следующего величин:

Значение Величины
DISP_CHANGE_SUCCESSFUL изменение установочных параметров имело успех.
DISP_CHANGE_RESTART компьютер должен быть перезапущен для того, чтобы графический режим, чтобы работать.
DISP_CHANGE_BADFLAGS инвалид установленный флагов был пройден в.
DISP_CHANGE_FAILED дисплейный драйвер терпел неудачу определенный графический режим.
DISP_CHANGE_BADMODE графический режим не поддерживан.
DISP_CHANGE_NOTUPDATED Windows NT только: Не в состоянии записать установочные параметры в регистрацию.

Замечания

Использование DEVMODE возвращанный функцией EnumDisplaySettings гарантирует, что DEVMODE пройденное на ChangeDisplaySettings - в силе и содержит только величины поддерживанные дисплейным драйвером.
Когда дисплейный режим изменяется динамически, сообщение WM_DISPLAYCHANGE послано в весь прогон приложений с следующими параметрами сообщения:

Параметры, означающие Новые биты wParam за пиксель LOWORD(lParam) Новая ширина пикселя HIWORD(lParam) Новая высота пикселя

Смотри Также

CreateDC, DEVMODE, EnumDisplaySettings, WM_DISPLAYCHANGE

Используются технологии uCoz