GetNumberOfConsoleInputEvents

コンソールの入力バッファ内の未読入力レコード数を取得する。

GetNumberOfConsoleInputEvents hConsoleInput, lpNumberOfEvents

hConsoleInput : [intptr] コンソール入力バッファのハンドル。ハンドルは **GENERIC\_READ** アクセス権を持つ必要がある。詳細は [Console Buffer Security and Access Rights](console-buffer-security-and-access-rights.md) を参照。
lpNumberOfEvents : [var] 

(プラグイン / モジュール : kernel32.dll)

解説

コンソールの入力バッファ内の未読入力レコード数を取得する。

[戻り値]
関数が成功した場合、戻り値は 0 以外。関数が失敗した場合、戻り値は 0。拡張エラー情報を取得するには
[**GetLastError**](/windows/win32/api/errhandlingapi/nf-errhandlingapi-getlasterror)
を呼ぶ。

[備考]
**GetNumberOfConsoleInputEvents**
関数は、入力バッファ内の未読入力レコードの総数(キーボード、マウス、ウィンドウサイズ変更入力レコードを含む)を報告する。[**ReadFile**](/windows/win32/api/fileapi/nf-fileapi-readfile)
または [**ReadConsole**](readconsole.md)
関数を使用するプロセスはキーボード入力のみを読み取れる。[**ReadConsoleInput**](readconsoleinput.md)
関数を使用するプロセスはあらゆる種類の入力レコードを読み取れる。プロセスは、未読のコンソール入力があるタイミングを判定するために、待機関数の
1
つにコンソール入力バッファのハンドルを指定できる。入力バッファが空でない場合、コンソール入力バッファのハンドルの状態はシグナル状態となる。未読レコード数に影響を与えずにコンソール入力バッファから入力レコードを読み取るには、[**PeekConsoleInput**](peekconsoleinput.md)
関数を使用する。コンソールの入力バッファ内のすべての未読レコードを破棄するには、[**FlushConsoleInputBuffer**](flushconsoleinputbuffer.md)
関数を使用する。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs