GetConsoleScreenBufferInfoEx

指定したコンソール画面バッファに関する拡張情報を取得する。

GetConsoleScreenBufferInfoEx hConsoleOutput, lpConsoleScreenBufferInfoEx

hConsoleOutput : [intptr] コンソール画面バッファへのハンドル。このハンドルは **GENERIC\_READ** アクセス権を持っている必要がある。詳細は [Console Buffer Security and Access Rights](console-buffer-security-and-access-rights.md) を参照。
lpConsoleScreenBufferInfoEx : [var] 要求されたコンソール画面バッファ情報を受け取る [**CONSOLE\_SCREEN\_BUFFER\_INFOEX**](console-screen-buffer-infoex.md) 構造体。

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

解説

指定したコンソール画面バッファに関する拡張情報を取得する。

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

[備考]

[**CONSOLE\_SCREEN\_BUFFER\_INFOEX**](console-screen-buffer-infoex.md)
構造体の **srWindow** メンバで返される矩形は変更してから
[**SetConsoleWindowInfo**](setconsolewindowinfo.md)
関数に渡すことで、ウィンドウ内のコンソール画面バッファをスクロールしたり、ウィンドウのサイズを変更したり、その両方を行ったりできる。[**CONSOLE\_SCREEN\_BUFFER\_INFOEX**](console-screen-buffer-infoex.md)
構造体で返されるすべての座標は文字セル座標で、原点 (0, 0) はコンソール画面バッファの左上隅にある。> [!TIP] > この
API には **[virtual terminal](console-virtual-terminal-sequences.md)**
に相当するものはない。列やグリッドを描画したり、表示を埋めるためにウィンドウサイズを取得しようとするアプリケーションでは依然として使う必要がある場合がある。このウィンドウ状態は通常のストリームフローの外側で
TTY/PTY/Pseudoconsole
によって管理されており、一般的にはクライアントアプリケーションが調整できないユーザー権限と見なされている。更新は
[**ReadConsoleInput**](readconsoleinput.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