FFmpeg 4.3硬件加速检测咨询（C++录屏开发场景）

我之前在FFmpeg 4.x环境下做硬件编码器检测时也遇到过完全一样的问题：调用avcodec_find_encoder_by_name("h264_qsv")返回null，但实际编码器明明能正常工作。结合FFmpeg 4.3的特性，给你梳理几个可行的解决思路：

1. 确保FFmpeg组件正确初始化 #

FFmpeg 4.3中虽然av_register_all()被标记为废弃，但它内部会统一注册编码器、解码器等所有组件。如果你的代码没做初始化，很可能导致编码器未被加载：

#include <libavcodec/avcodec.h>
#include <libavutil/hwcontext.h>

int main() {
    // 开启调试日志，方便排查问题
    av_log_set_level(AV_LOG_DEBUG);
    // 初始化所有FFmpeg组件（4.3版本仍可使用，内部会完成编码器注册）
    av_register_all();

    // 后续检测逻辑...
}

如果不想用废弃接口，可以拆分调用：

avcodec_register_all(); // 注册编码器/解码器
avformat_register_all(); // 注册封装/解封装器
avfilter_register_all(); // 注册滤镜（如果用到）

2. 动态加载硬件编码器模块（针对动态编译的FFmpeg） #

如果你的FFmpeg是动态编译的，部分硬件编码器（比如QSV、NVENC）可能以独立模块文件存在（Windows下是.dll，Linux下是.so），需要手动加载：

AVCodec* find_hw_encoder(const char* encoder_name, const char* module_path = nullptr) {
    AVCodec* codec = avcodec_find_encoder_by_name(encoder_name);
    if (!codec && module_path) {
        // 尝试加载指定模块
        if (avcodec_load_library(module_path) >= 0) {
            codec = avcodec_find_encoder_by_name(encoder_name);
        }
    }
    return codec;
}

// 调用示例（Windows下QSV编码器模块路径）
AVCodec* qsv_codec = find_hw_encoder("h264_qsv", "qsvenc_h264.dll");

模块文件名可以根据你的FFmpeg编译结果调整，比如NVENC对应的模块可能是nvenc_h264.dll。

3. 结合硬件设备上下文验证编码器可用性 #

即使找到了编码器，也需要确认当前硬件支持该编码器的加速功能。核心思路是先创建对应硬件的设备上下文，再验证编码器是否适配：

检测h264_qsv（Intel QSV） #

bool is_h264_qsv_supported() {
    AVBufferRef* hw_device_ctx = nullptr;
    // 创建QSV硬件设备上下文
    int ret = av_hwdevice_ctx_create(&hw_device_ctx, AV_HWDEVICE_TYPE_QSV, nullptr, nullptr, 0);
    if (ret < 0) {
        av_log(nullptr, AV_LOG_WARNING, "Failed to create QSV device: %s\n", av_err2str(ret));
        return false;
    }

    // 查找编码器
    AVCodec* codec = avcodec_find_encoder_by_name("h264_qsv");
    bool supported = false;
    if (codec) {
        // 检查编码器是否支持QSV硬件加速
        const AVCodecHWConfig* hw_config = avcodec_get_hw_config(codec, AV_HWDEVICE_TYPE_QSV);
        if (hw_config) {
            supported = true;
            av_log(nullptr, AV_LOG_INFO, "h264_qsv is supported\n");
        }
    }

    // 释放设备上下文
    av_buffer_unref(&hw_device_ctx);
    return supported;
}

检测h264_nvenc（NVIDIA NVENC） #

bool is_h264_nvenc_supported() {
    AVBufferRef* hw_device_ctx = nullptr;
    // 创建CUDA硬件设备上下文（NVENC依赖CUDA）
    int ret = av_hwdevice_ctx_create(&hw_device_ctx, AV_HWDEVICE_TYPE_CUDA, nullptr, nullptr, 0);
    if (ret < 0) {
        av_log(nullptr, AV_LOG_WARNING, "Failed to create CUDA device: %s\n", av_err2str(ret));
        return false;
    }

    AVCodec* codec = avcodec_find_encoder_by_name("h264_nvenc");
    bool supported = false;
    if (codec) {
        const AVCodecHWConfig* hw_config = avcodec_get_hw_config(codec, AV_HWDEVICE_TYPE_CUDA);
        if (hw_config) {
            supported = true;
            av_log(nullptr, AV_LOG_INFO, "h264_nvenc is supported\n");
        }
    }

    av_buffer_unref(&hw_device_ctx);
    return supported;
}

4. 遍历所有编码器排查问题 #

如果直接查找名字失败，可以遍历所有已注册的编码器，确认目标编码器是否存在：

void check_all_encoders() {
    void* iter = nullptr;
    const AVCodec* codec = nullptr;
    av_log(nullptr, AV_LOG_INFO, "Available encoders:\n");
    while ((codec = av_codec_iterate(&iter))) {
        if (av_codec_is_encoder(codec)) {
            av_log(nullptr, AV_LOG_INFO, "  %s\n", codec->name);
        }
    }
}

调用这个函数后，查看日志里是否有h264_qsv或h264_nvenc，如果没有，说明你的FFmpeg编译时未包含这些编码器，需要重新编译并开启对应的配置项（比如QSV需要--enable-libmfx，NVENC需要--enable-nvenc）。

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