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

참고 항목

콘솔 함수

CONSOLE_SCREEN_BUFFER_INFOEX

SetConsoleScreenBufferInfoEx