使用WinAPI与kernel32实现Windows控制台向上滚动失败排查

你在把微软的C语言控制台滚动示例改写为Rust时遇到了向上滚动失效的问题，我帮你梳理下代码里的关键问题，以及对应的修复方案：

问题根源分析 #

你的scroll_up函数里存在三个核心问题：

1. 滚动条件判断过于严格：当前的if srctWindow.Top >= rows会直接放弃所有Top小于rows的情况，但实际上这种场景下我们可以滚动到缓冲区顶部（Top=0），而不是直接判定失败。
2. 未处理无效窗口矩形：如果srctWindow.Top - rows小于0，直接修改Top和Bottom会生成无效的SMALL_RECT（Top >= Bottom 或坐标为负），导致SetConsoleWindowInfo调用失败。
3. 缺少API调用错误检查：原代码没有检查GetStdHandle和GetConsoleScreenBufferInfo的返回值，如果这些调用失败，后续的窗口坐标计算都会基于错误的零值数据，直接导致滚动逻辑失效。

修复后的代码 #

下面是修正后的完整代码，同时补充了必要的错误检查逻辑：

extern crate kernel32;
extern crate winapi;
use std::mem;
use winapi::{INVALID_HANDLE_VALUE, TRUE};

fn main() {
    for i in 0..100 {
        println!("Just some data to scroll over {}", i);
    }
    scroll_up(10);
}

pub fn scroll_up(rows: i16) {
    unsafe {
        // 获取标准输出句柄，检查是否有效
        let h_stdout = kernel32::GetStdHandle(winapi::STD_OUTPUT_HANDLE);
        if h_stdout == INVALID_HANDLE_VALUE {
            println!("Failed to get stdout handle");
            return;
        }

        // 获取控制台屏幕缓冲区信息，检查调用是否成功
        let mut csbi_info: winapi::CONSOLE_SCREEN_BUFFER_INFO = mem::zeroed();
        if kernel32::GetConsoleScreenBufferInfo(h_stdout, &mut csbi_info) == 0 {
            println!("Failed to get console screen buffer info");
            return;
        }

        let mut src_window = csbi_info.srWindow;
        // 计算当前窗口的高度（包含上下边界，所以+1）
        let window_height = src_window.Bottom - src_window.Top + 1;
        // 计算目标Top值，不能小于0
        let new_top = std::cmp::max(src_window.Top - rows, 0);
        // 计算目标Bottom值，保证窗口高度不变且不超过缓冲区最大Y坐标
        let new_bottom = new_top + window_height - 1;
        
        if new_bottom <= csbi_info.dwSize.Y - 1 {
            src_window.Top = new_top;
            src_window.Bottom = new_bottom;
            if kernel32::SetConsoleWindowInfo(h_stdout, TRUE, &src_window) == 0 {
                println!("Failed to set console window info");
            }
        } else {
            println!("Cannot scroll up further");
        }
    }
}

pub fn scroll_down(rows: i16) {
    unsafe {
        let h_stdout = kernel32::GetStdHandle(winapi::STD_OUTPUT_HANDLE);
        if h_stdout == INVALID_HANDLE_VALUE {
            println!("Failed to get stdout handle");
            return;
        }

        let mut csbi_info: winapi::CONSOLE_SCREEN_BUFFER_INFO = mem::zeroed();
        if kernel32::GetConsoleScreenBufferInfo(h_stdout, &mut csbi_info) == 0 {
            println!("Failed to get console screen buffer info");
            return;
        }

        let mut src_window = csbi_info.srWindow;
        let window_height = src_window.Bottom - src_window.Top + 1;
        let new_top = src_window.Top + rows;
        let new_bottom = new_top + window_height - 1;

        if new_bottom <= csbi_info.dwSize.Y - 1 {
            src_window.Top = new_top;
            src_window.Bottom = new_bottom;
            if kernel32::SetConsoleWindowInfo(h_stdout, TRUE, &src_window) == 0 {
                println!("Failed to set console window info");
            }
        } else {
            println!("Cannot scroll down further");
        }
    }
}

关键修改说明 #

• 补充API错误检查：在调用GetStdHandle和GetConsoleScreenBufferInfo后立即检查返回值，避免基于无效数据执行后续逻辑。
• 正确计算窗口高度：考虑到SMALL_RECT的坐标是包含边界的，窗口高度需要用Bottom - Top + 1计算。
• 修正滚动边界判断：向上滚动时用std::cmp::max确保目标Top不小于0，同时保证窗口高度不变且不超出缓冲区范围；向下滚动也做了同样的边界修正，逻辑更严谨。

你的Cargo依赖使用的是较旧版本的winapi和kernel32-sys，如果后续遇到类型定义问题，可以考虑升级到较新的版本（比如winapi = "0.3"系列），不过当前修复后的代码在你的依赖版本下也能正常运行。

内容的提问来源于stack exchange，提问作者Timon Post