Функция GetConsoleScreenBufferInfoEx
Извлекает расширенные сведения о указанном буфере экрана консоли.
Синтаксис
BOOL WINAPI GetConsoleScreenBufferInfoEx(
_In_ HANDLE hConsoleOutput,
_Out_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);
Параметры
hConsoleOutput [ввод]
Дескриптор буфера экрана консоли. Этот дескриптор должен иметь право доступа GENERIC_READ. Дополнительные сведения см. в статье Безопасность и права доступа для буфера консоли.
lpConsoleScreenBufferInfoEx [out]
Структура CONSOLE_SCREEN_BUFFER_INFOEX , которая получает запрошенные сведения о буфере экрана консоли.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Замечания
Прямоугольник, возвращенный в элементе srWindow структуры CONSOLE_SCREEN_BUFFER_INFOEX, можно изменить, а затем передать в функцию SetConsoleWindowInfo для прокрутки буфера экрана консоли в окне, чтобы изменить размер окна или оба.
Все координаты, возвращаемые в структуре CONSOLE_SCREEN_BUFFER_INFOEX, находятся в координатах ячейки символов, где источник (0, 0) находится в левом верхнем углу буфера экрана консоли.
Совет
Этот API не имеет эквивалента виртуального терминала . Его использование может по-прежнему потребоваться для приложений, которые пытаются нарисовать столбцы, сетки или заполнить отображение для получения размера окна. Это состояние окна управляется TTY/PTY/Pseudoconsole за пределами обычного потока потока и обычно считается привилегией пользователя, не настраиваемой клиентским приложением. Обновления можно получить на ReadConsoleInput.
Requirements
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Верхний колонтитул | ConsoleApi2.h (через WinCon.h, включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL-библиотеки | Kernel32.dll |