GetConsoleDisplayMode 함수

Important

이 문서에서는 더 이상 에코시스템 로드맵의 일부가 되지 않는 콘솔 플랫폼 기능에 대해 설명합니다. 이 콘텐츠를 신제품에서 사용하지 않는 것이 좋지만, 무기한 앞으로도 기존 사용을 계속 지원할 것입니다. 선호하는 최신 솔루션은 플랫폼 간 시나리오에서 최대 호환성을 위해 가상 터미널 시퀀스에 중점을 둡니다. 이 디자인 결정에 대한 자세한 내용은 클래식 콘솔과 가상 터미널 문서에서 확인할 수 있습니다.

현재 콘솔의 표시 모드를 검색합니다.

구문

BOOL WINAPI GetConsoleDisplayMode(
  _Out_ LPDWORD lpModeFlags
);

매개 변수

lpModeFlags [out]
콘솔의 표시 모드입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

값	의미
CONSOLE_FULLSCREEN 1	전체 화면 콘솔. 콘솔은 창이 최대화되는 즉시 이 모드에 있습니다. 이 시점에서 전체 화면 모드로의 전환은 여전히 실패할 수 있습니다.
CONSOLE_FULLSCREEN_HARDWARE 2	비디오 하드웨어와 직접 통신하는 전체 화면 콘솔입니다. 이 모드는 콘솔이 CONSOLE_FULLSCREEN 모드에 있으면 전체 화면 모드로의 전환이 완료되었음을 나타내기 위해 설정됩니다.

참고 항목

그래픽 스택을 WDDM으로 다시 배치하여 Windows Vista에서 100% 전체 화면 비디오 하드웨어 모드로의 전환이 제거되었습니다. 이후 버전의 Windows에서 최대 결과 상태는 전체 화면으로 표시되지만 하드웨어를 단독으로 제어하지 않는 프레임 없는 창을 나타내는 CONSOLE_FULLSCREEN.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0500 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조 하세요.

팁

이 API는 권장되지 않으며 해당하는 가상 터미널이 없습니다. 이 결정은 사용자가 이 프레젠테이션 옵션을 완전히 제어할 수 있는 다른 운영 체제와 Windows 플랫폼을 의도적으로 조정합니다. 이 API를 사용하는 경우 플랫폼 간 유틸리티 및 SSH와 같은 전송을 통한 애플리케이션 원격 작업이 예상대로 작동하지 않을 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003[데스크톱 앱만 해당]
헤더	ConsoleApi3.h(WinCon.h를 통해 Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

콘솔 함수

콘솔 모드

SetConsoleDisplayMode