UEFI Shell StdOut输出异常：无法获取EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL

云上老周

2026-7-29

EFI_SHELL_PARAMETERS_PROTOCOL.StdOut 相关问题解析

问题根源

你调用OpenProtocol获取EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL返回EFI_INVALID_PARAMETER，核心原因是：EFI_SHELL_PARAMETERS_PROTOCOL的StdOut字段是**EFI_FILE_HANDLE类型**，该句柄仅安装了EFI_FILE_PROTOCOL，并未安装EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL。

关键概念梳理

StdOut的设计定位：它是Shell提供的标准输出抽象句柄，遵循EFI_FILE_PROTOCOL规范，支持流式输出场景（比如输出重定向到文件、管道），而非直接用于控制台文本输出控制。
与ConOutHandle的差异：EFI_SYSTEM_TABLE.ConOutHandle是绑定物理控制台设备的句柄，自带EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL，适合直接输出格式化文本到控制台；而StdOut是Shell层对标准输出的封装，统一了不同输出目标的写入接口。

正确使用方式

若要通过StdOut输出内容，需先获取其EFI_FILE_PROTOCOL接口，再调用Write方法写入数据，示例代码：

EFI_FILE_PROTOCOL *std_out_file;
EFI_STATUS status = gBS->OpenProtocol(
    shell_params->StdOut,
    &gEfiFileProtocolGuid,
    (VOID**)&std_out_file,
    image_handle,
    NULL,
    EFI_OPEN_PROTOCOL_GET_PROTOCOL
);

if (!EFI_ERROR(status)) {
    CHAR16 output[] = L"Output via StdOut\n";
    UINTN bytes_written;
    std_out_file->Write(std_out_file, &bytes_written, output);
}