GetNumberOfConsoleInputEvents

【勇芳软件工作室】汉化HomePreviousNext

GetNumberOfConsoleInputEvents函数检索控制台输入缓冲区中未读输入记录的数量。

BOOL GetNumberOfConsoleInputEvents(

HANDLE 【hConsoleInput】,//控制台输入缓冲区的句柄
LPDWORD 【lpcNumberOfEvents】//地址为事件数
); 

参数

【hConsoleInput】

标识控制台输入缓冲区。句柄必须具有GENERIC_READ权限。

【lpcNumberOfEvents】

指向接收控制台输入缓冲区中未读输入记录数的32位变量。

返回值

如果函数成功,返回值不为零。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

GetNumberOfConsoleInputEvents功能报告输入缓冲区中未读输入记录的总数,包括键盘,鼠标和调整窗口大小的输入记录。使用ReadFileReadConsole功能的进程只能读取键盘输入。使用ReadConsoleInput功能的进程可以读取所有类型的输入记录。

一个进程可以在等待功能之一中指定控制台输入缓冲区句柄,以确定何时有未读的控制台输入。当输入缓冲区不为空时,会发出控制台输入缓冲区句柄的状态。

要从控制台输入缓冲区读取输入记录,而不影响未读记录的数量,请使用PeekConsoleInput功能。要放弃控制台输入缓冲区中的所有未读记录,请使用FlushConsoleInputBuffer功能。

也可以看看

FlushConsoleInputBuffer, PeekConsoleInput, ReadConsole, ReadConsoleInput, ReadFile