На главную

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 | Скачать Вниз

EnumDisplaySettings



The EnumDisplaySettings function obtains information about one of a display device's graphics modes. You can obtain information for all of a display device's graphics modes by making a series of calls to this function.

BOOL EnumDisplaySettings(

LPCTSTR lpszDeviceName, // specifies the display device
DWORD iModeNum, // specifies the graphics mode
LPDEVMODE lpDevMode // points to structure to receive settings
);


Parameters

lpszDeviceName

Pointer to a null-terminated string that specifies the display device whose graphics mode the function will obtain information about.
This parameter can be NULL. A NULL value specifies the current display device on the computer that the calling thread is running on.
If lpszDeviceName is not NULL, the string must be of the form \\.\DisplayX, where X can have the values 1, 2, or 3.
Windows 95: lpszDeviceName must be NULL.

iModeNum

Index value that specifies the graphics mode for which information is to be obtained.
Graphics mode indexes start at zero. To obtain information for all of a display device's graphics modes, make a series of calls to EnumDisplaySettings, as follows: Set iModeNum to zero for the first call, and increment iModeNum by one for each subsequent call. Continue calling the function until the return value is FALSE.
When you call EnumDisplaySettings with iModeNum set to zero, the operating system initializes and caches information about the display device. When you call EnumDisplaySettings with iModeNum set to a non-zero value, the function returns the information that was cached the last time the function was called with iModeNum set to zero.

lpDevMode

Pointer to a DEVMODE structure into which the function stores information about the specified graphics mode.
The EnumDisplaySettings function sets values for the following five DEVMODE members:

dmBitsPerPel
dmPelsWidth
dmPelsHeight
dmDisplayFlags
dmDisplayFrequency



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
The function fails if iModeNum is greater than the index of the display device's last graphics mode. As noted in the description of the iModeNum parameter, you can use this behavior to enumerate all of a display device's graphics modes.

See Also

ChangeDisplaySettings, CreateDC, CreateDesktop, DEVMODE


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

EnumDisplaySettings



Функция EnumDisplaySettings получает информацию о одном из дисплейного устройства графические режимы. Вы можете получить информацию для всех графических режимов дисплейного устройства делая серией вызовов в эту функцию.

BOOL EnumDisplaySettings(

LPCTSTR lpszDeviceName, // ОПРЕДЕЛЯЕТ дисплейное устройство DWORD iModeNum, // определяет графические точки режима LPDEVMODE lpDevMode // на структуру, чтобы получать установочные параметры
);


Параметры

lpszDeviceName

Указатель в недействительный расторгнутую строку, которая определяет дисплейное устройство, чей графический режим функция получит информацию о.
Этот параметр может быть НЕДЕЙСТВИТЕЛЕН. НЕДЕЙСТВИТЕЛЬНАЯ величина определяет текущее дисплейное устройство в компьютере, что вызывающая резьба работает на.
Если lpszDeviceName не НЕДЕЙСТВИТЕЛЕН, строка должна быть формы \\.\DisplayX, где X может иметь величины 1, 2, или 3.
Windows 95: lpszDeviceName должен быть НЕДЕЙСТВИТЕЛЕН.

iModeNum

Индексная величина, что определяет графический режим для которого информация должна быть получена.
Графический режим индексирует начало в нуле. Для того, чтобы получать информацию для всех графических режимов дисплейного устройства, сделайте серией вызовов на EnumDisplaySettings, следующим образом: Установите iModeNum в нуль для первого вызова, и приращения iModeNum за каждого последующего вызова. Продолжите вызывать функцию пока обратная величина не будет ЛОЖНОЙ.
Когда Вы называете EnumDisplaySettings с iModeNum установленное в нуль, операционная система инициализирует и кеширует информацию о дисплейном устройстве. Когда Вы называете EnumDisplaySettings с iModeNum установленное в не равным нулю величину, функция возвращает информацию, которая была кеширована в последний раз функция была названа iModeNum установленное в нуль.

lpDevMode

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

dmBitsPerPel dmPelsWidth dmPelsHeight dmDisplayFlags dmDisplayFrequency



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

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая.
Функция терпит неудачу если iModeNum больше, чем индекс дисплейного последнего графического режима устройства. Как отмечено в описании параметра iModeNum, Вы можете использовать это поведение, чтобы перечислять все графические режимы дисплейного устройства.

Смотри Также

ChangeDisplaySettings, CreateDC, CreateDesktop, DEVMODE


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz