GetConsoleScreenBufferInfoEx 함수
지정된 콘솔 화면 버퍼에 대한 확장 정보를 검색합니다.
구문
BOOL WINAPI GetConsoleScreenBufferInfoEx(
_In_ HANDLE hConsoleOutput,
_Out_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);
매개 변수
hConsoleOutput [in]
콘솔 화면 버퍼에 대한 핸들입니다. 핸들에는 GENERIC_READ 액세스 권한이 있어야 합니다. 자세한 내용은 콘솔 버퍼 보안 및 액세스 권한을 참조하세요.
lpConsoleScreenBufferInfoEx [out]
요청된 콘솔 화면 버퍼 정보를 수신하는 CONSOLE_SCREEN_BUFFER_INFOEX 구조체입니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
CONSOLE_SCREEN_BUFFER_INFOEX 구조체의 srWindow 멤버에 반환된 사각형을 수정한 다음 SetConsoleWindowInfo 함수로 전달하여 창의 콘솔 화면 버퍼를 스크롤하거나 창의 크기를 변경하거나 둘 다 변경할 수 있습니다.
CONSOLE_SCREEN_BUFFER_INFOEX 구조에서 반환되는 모든 좌표는 문자 셀 좌표로, 원점(0, 0)은 콘솔 화면 버퍼의 왼쪽 위 모서리에 있습니다.
팁
이 API에는 해당하는 가상 터미널이 없습니다. 창 크기를 검색하기 위해 열, 눈금 또는 디스플레이를 채우려는 애플리케이션에는 계속 사용해야 할 수 있습니다. 이 창 상태는 일반 스트림 흐름 외부의 TTY/PTY/Pseudoconsole에서 관리되며 일반적으로 클라이언트 애플리케이션에서 조정할 수 없는 사용자 권한으로 간주됩니다. 업데이트 받을 수 있습니다.ReadConsoleInput.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 | ConsoleApi2.h(WinCon.h를 통해 Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |