GetNumberOfConsoleInputEvents函数检索控制台输入缓冲区中未读输入记录的数量。
BOOL GetNumberOfConsoleInputEvents(
HANDLE 【hConsoleInput】, | //控制台输入缓冲区的句柄 |
LPDWORD 【lpcNumberOfEvents】 | //地址为事件数 |
); |
参数
【hConsoleInput】
标识控制台输入缓冲区。句柄必须具有GENERIC_READ权限。
【lpcNumberOfEvents】
指向接收控制台输入缓冲区中未读输入记录数的32位变量。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
GetNumberOfConsoleInputEvents功能报告输入缓冲区中未读输入记录的总数,包括键盘,鼠标和调整窗口大小的输入记录。使用ReadFile或ReadConsole功能的进程只能读取键盘输入。使用ReadConsoleInput功能的进程可以读取所有类型的输入记录。
一个进程可以在等待功能之一中指定控制台输入缓冲区句柄,以确定何时有未读的控制台输入。当输入缓冲区不为空时,会发出控制台输入缓冲区句柄的状态。
要从控制台输入缓冲区读取输入记录,而不影响未读记录的数量,请使用PeekConsoleInput功能。要放弃控制台输入缓冲区中的所有未读记录,请使用FlushConsoleInputBuffer功能。
也可以看看
FlushConsoleInputBuffer, PeekConsoleInput, ReadConsole, ReadConsoleInput, ReadFile