ReadConsoleInputEx 함수

콘솔 입력 버퍼에서 데이터를 읽고 구성 가능한 동작으로 버퍼에서 제거합니다.

구문

BOOL WINAPI ReadConsoleInputEx(
  _In_  HANDLE        hConsoleInput,
  _Out_ PINPUT_RECORD lpBuffer,
  _In_  DWORD         nLength,
  _Out_ LPDWORD       lpNumberOfEventsRead,
  _In_  USHORT        wFlags
);

매개 변수

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

lpBuffer [out]
입력 버퍼 데이터를 수신하는 INPUT_RECORD 구조체 배열에 대한 포인터입니다.

nLength [in]
배열 요소에서 lpBuffer 매개 변수가 가리키는 배열의 크기입니다.

lpNumberOfEventsRead [out]
읽은 입력 레코드 수를 받는 변수에 대한 포인터입니다.

wFlags [in]

콘솔의 읽기 동작을 지정하는 플래그 집합(함께 ORed)입니다.

반환 값

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

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

설명

이 함수는 구성 가능한 버전의 ReadConsoleInput. 추가 운영 세부 정보는 비고 ReadConsoleInput 를 참조하세요.

플래그 CONSOLE_READ_NOMOVE | CONSOLE_READ_NOWAIT 를 사용하여 호출 ReadConsoleInputEx 하는 것은 호출PeekConsoleInput과 동일합니다.

이 함수는 Windows 콘솔 헤더에 없습니다. C 또는 C++ 애플리케이션에서 액세스하려면 다음 선언을 포함하고 위에서 설명한 대로 kernel32.dll 동적으로 연결합니다.

#ifndef CONSOLE_READ_NOREMOVE
#define CONSOLE_READ_NOREMOVE   0x0001
#endif

#ifndef CONSOLE_READ_NOWAIT
#define CONSOLE_READ_NOWAIT     0x0002
#endif

BOOL
WINAPI
ReadConsoleInputExA(
    _In_ HANDLE hConsoleInput,
    _Out_writes_(nLength) PINPUT_RECORD lpBuffer,
    _In_ DWORD nLength,
    _Out_ LPDWORD lpNumberOfEventsRead,
    _In_ USHORT wFlags);

BOOL
WINAPI
ReadConsoleInputExW(
    _In_ HANDLE hConsoleInput,
    _Out_writes_(nLength) PINPUT_RECORD lpBuffer,
    _In_ DWORD nLength,
    _Out_ LPDWORD lpNumberOfEventsRead,
    _In_ USHORT wFlags);

요구 사항

참고 항목

콘솔 함수

FlushConsoleInputBuffer

GetNumberOfConsoleInputEvents

INPUT_RECORD

하위 수준 콘솔 입력 함수

ReadConsoleInput

PeekConsoleInput

ReadConsole

ReadFile

SetConsoleCP

SetConsoleOutputCP

WriteConsoleInput