GetNumberOfConsoleInputEvents 함수

아티클
07/12/2023

콘솔의 입력 버퍼에서 읽지 않은 입력 레코드 수를 검색합니다.

구문

BOOL WINAPI GetNumberOfConsoleInputEvents(
  _In_  HANDLE  hConsoleInput,
  _Out_ LPDWORD lpcNumberOfEvents
);

매개 변수

hConsoleInput [in]
콘솔 입력 버퍼에 대한 핸들입니다. 핸들에는 GENERIC_READ 액세스 권한이 있어야 합니다. 자세한 내용은 콘솔 버퍼 보안 및 액세스 권한을 참조하세요.

lpcNumberOfEvents [out]
콘솔의 입력 버퍼에서 읽지 않은 입력 레코드 수를 받는 변수에 대한 포인터입니다.

반환 값

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

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

설명

GetNumberOfConsoleInputEvents 함수는 키보드, 마우스 및 창 크기 조정 입력 레코드를 포함하여 입력 버퍼의 읽지 않은 입력 레코드의 총 수를 보고합니다. ReadFile 또는 ReadConsole 함수를 사용하는 프로세스는 키보드 입력만 읽을 수 있습니다. ReadConsoleInput 함수를 사용하는 프로세스는 모든 유형의 입력 레코드를 읽을 수 있습니다.

프로세스는 대기 함수 중 하나에서 콘솔 입력 버퍼 핸들을 지정하여 읽지 않은 콘솔 입력이 있는 시기를 결정할 수 있습니다. 입력 버퍼가 비어 있지 않으면 콘솔 입력 버퍼 핸들의 상태가 신호를 수신합니다.

읽지 않은 레코드 수에 영향을 주지 않고 콘솔 입력 버퍼에서 입력 레코드를 읽으려면 PeekConsoleInput 함수를 사용합니다. 콘솔의 입력 버퍼에서 읽지 않은 모든 레코드를 카드 없도록 하려면 FlushConsoleInputBuffer 함수를 사용합니다.

요구 사항


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