Функция GetConsoleDisplayMode

Важно!

В этом документе описаны функции платформы консоли, которые больше не являются частью стратегии развития экосистемы. Мы не рекомендуем использовать это содержимое в новых продуктах, но мы будем продолжать поддерживать существующие использования для неопределенного будущего. Наше предпочтительное современное решение ориентировано на последовательности виртуальных терминалов для обеспечения максимальной совместимости в кроссплатформенных сценариях. Дополнительные сведения об этом решении по проектированию можно найти в классической консоли и в документе виртуального терминала .

Извлекает режим отображения текущей консоли.

Синтаксис

BOOL WINAPI GetConsoleDisplayMode(
  _Out_ LPDWORD lpModeFlags
);

Параметры

lpModeFlags [out]
Режим отображения консоли. Этот параметр может быть одним или несколькими из следующих значений.

Значение	Значение
CONSOLE_FULLSCREEN 1	Полноэкранная консоль. Консоль находится в этом режиме, как только окно будет развернуто. На этом этапе переход на полноэкранный режим по-прежнему может завершиться ошибкой.
CONSOLE_FULLSCREEN_HARDWARE 2	Полноэкранная консоль напрямую взаимодействует с видео оборудованием. Этот режим устанавливается после того, как консоль находится в режиме CONSOLE_FULLSCREEN , чтобы указать, что переход на полноэкранный режим завершен.

Примечание.

Переход на 100% полноэкранный режим оборудования видео был удален в Windows Vista с переформированием графического стека на WDDM. В более поздних версиях Windows максимальное итоговое состояние CONSOLE_FULLSCREEN представляет окно без фреймов, которое отображается в полноэкранном режиме, но не находится под монопольным контролем оборудования.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Замечания

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0500 или более поздней версии. Дополнительные сведения см. в разделе "Использование заголовков Windows".

Совет

Этот API не рекомендуется и не имеет эквивалента виртуального терминала . Это решение намеренно выравнивает платформу Windows с другими операционными системами, где пользователь получает полный контроль над этим параметром презентации. Удаленное взаимодействие приложений с помощью межплатформенных служебных программ и транспорта, таких как SSH, может не работать должным образом, если используется этот API.

Requirements

Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхний колонтитул	ConsoleApi3.h (через WinCon.h, включая Windows.h)
Библиотека	Kernel32.lib
DLL-библиотеки	Kernel32.dll

См. также

Функции консоли

Консольные режимы

SetConsoleDisplayMode