GetNumberOfConsoleInputEvents function

Retrieves the number of unread input records in the console's input buffer.

Syntax


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

Parameters

hConsoleInput [in]

A handle to the console input buffer. The handle must have the GENERIC_READ access right. For more information, see Console Buffer Security and Access Rights.

lpcNumberOfEvents [out]

A pointer to a variable that receives the number of unread input records in the console's input buffer.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The GetNumberOfConsoleInputEvents function reports the total number of unread input records in the input buffer, including keyboard, mouse, and window-resizing input records. Processes using the ReadFile or ReadConsole function can only read keyboard input. Processes using the ReadConsoleInput function can read all types of input records.

A process can specify a console input buffer handle in one of the wait functions to determine when there is unread console input. When the input buffer is not empty, the state of a console input buffer handle is signaled.

To read input records from a console input buffer without affecting the number of unread records, use the PeekConsoleInput function. To discard all unread records in a console's input buffer, use the FlushConsoleInputBuffer function.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wincon.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Console Functions
FlushConsoleInputBuffer
Low-Level Console Input Functions
PeekConsoleInput
ReadConsole
ReadConsoleInput
ReadFile

 

 

Community Additions

ADD
Show:
© 2014 Microsoft