Windows下如何获取GetConsoleMode()所需的输出控制台屏幕缓冲区句柄？

正确实现代码 #

要修改控制台输出的模式，需要通过CreateFile打开CONOUT$获取活动屏幕缓冲区的句柄，再调用GetConsoleMode和SetConsoleMode操作。完整代码示例如下：

#include <windows.h>

int main() {
    HANDLE hStdOut;
    DWORD fdwSaveOldMode;

    // 打开控制台活动屏幕缓冲区
    hStdOut = CreateFile(
        L"CONOUT$",
        GENERIC_READ | GENERIC_WRITE,
        FILE_SHARE_READ | FILE_SHARE_WRITE,
        NULL,
        OPEN_EXISTING,
        0,
        NULL
    );

    if (hStdOut == INVALID_HANDLE_VALUE) {
        // 错误处理：打印错误码或执行其他逻辑
        return GetLastError();
    }

    // 获取并保存原始输出模式
    if (!GetConsoleMode(hStdOut, &fdwSaveOldMode)) {
        CloseHandle(hStdOut);
        return GetLastError();
    }

    // 示例：禁用自动换行功能
    DWORD fdwNewMode = fdwSaveOldMode & ~ENABLE_WRAP_AT_EOL_OUTPUT;
    if (!SetConsoleMode(hStdOut, fdwNewMode)) {
        CloseHandle(hStdOut);
        return GetLastError();
    }

    // 这里可以执行自定义的输出操作
    WriteConsole(hStdOut, L"测试无自动换行输出...", 20, NULL, NULL);

    // 恢复原始输出模式并关闭句柄
    SetConsoleMode(hStdOut, fdwSaveOldMode);
    CloseHandle(hStdOut);

    return 0;
}

输入与输出操作的差异原因 #

• 输入缓冲区的唯一性：STD_INPUT_HANDLE指向的是全局唯一的控制台输入缓冲区，所有进程获取的输入句柄都对应同一个输入源，直接调用GetStdHandle就能拿到可修改模式的有效句柄，因此实现简单。
• 输出缓冲区的多实例特性：控制台支持多个屏幕缓冲区共存，STD_OUTPUT_HANDLE默认指向的是当前进程关联的私有输出缓冲区，而非用户可见的活动屏幕缓冲区。如果直接修改这个句柄的模式，只会影响当前进程的输出，无法作用到用户实际看到的控制台界面。
• CONOUT$的特殊作用：CONOUT$是控制台的虚拟设备名称，通过CreateFile打开它时，会直接获取当前处于活动状态的屏幕缓冲区句柄——也就是用户正在查看的那个输出区域。只有修改这个句柄的模式，才能让输出行为的变更在控制台界面上生效。

注意事项 #

• 打开CONOUT$时必须指定正确的访问权限（GENERIC_READ | GENERIC_WRITE）和共享模式（FILE_SHARE_READ | FILE_SHARE_WRITE），否则会因权限不足导致打开失败。
• 操作完成后务必关闭句柄，避免系统资源泄漏；同时建议恢复原始控制台模式，防止对后续的控制台操作产生意外影响。

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