FFmpeg C++配置cuvid硬解码指定GPU设备不生效如何解决

参数不生效有两个核心原因：

• hwaccel、hwaccel_device是FFmpeg命令行工具层的逻辑参数，不是libavcodec库中cuvid解码器可识别的内置选项。你把这两个键值传入avcodec_open2的参数字典，cuvid解码器根本无法识别，会直接忽略，最终默认使用0号GPU。
• cuvid硬解码器自身用于指定GPU设备的参数名是cuda_device，而非hwaccel_device。

任选以下一种方案修改即可：

方案1：传入cuvid可识别的正确参数（实现最简单） #

替换原有参数为cuvid支持的键名，注意必须显式指定使用cuvid后缀的硬解码器：

AVDictionary* options = nullptr;
// 不需要传hwaccel参数，只要选中_cuvid后缀的解码器就会走cuvid硬解
av_dict_set_int(&options, "cuda_device", 2, 0);

// 必须通过名称查找cuvid硬解码器，例如H264对应h264_cuvid、HEVC对应hevc_cuvid
const AVCodec* codec = avcodec_find_decoder_by_name("h264_cuvid");
// 打开解码器时传入参数字典
int ret = avcodec_open2(codec_ctx, codec, &options);

// 注意：avcodec_open2返回后，options中残留的键值对都是未被解码器识别的无效参数
av_dict_free(&options);

方案2：手动绑定指定GPU的CUDA上下文（生产环境推荐，可控性最高） #

不依赖字典传参，手动创建指定GPU的设备上下文绑定到编解码上下文，能100%确保设备指定正确：

int target_gpu = 2;
AVBufferRef* hw_device_ctx = nullptr;
// 直接创建指向2号GPU的CUDA硬件设备上下文
int ret = av_hwdevice_ctx_create(&hw_device_ctx, 
                                AV_HWDEVICE_TYPE_CUDA,
                                std::to_string(target_gpu).c_str(),
                                nullptr, 0);
// 将设备上下文绑定到编解码上下文
codec_ctx->hw_device_ctx = av_buffer_ref(hw_device_ctx);

// 后续正常打开解码器即可，不需要再传设备相关字典参数
avcodec_open2(codec_ctx, codec, nullptr);

// 用完后释放资源
av_buffer_unref(&hw_device_ctx);

方案3：自定义hwaccel回调场景的处理 #

如果你没有直接使用_cuvid后缀的硬解码器，而是给软解码器注册了自定义hwaccel加速回调，那么hwaccel_device参数不会被自动解析，需要你自己在get_format回调中读取该参数值，手动创建对应编号的GPU设备，否则就会默认走0号GPU。

程序运行后可以通过两种方式确认设备是否正确：

• 调用nvidia-smi命令，查看进程实际占用的GPU编号
• 在代码中调用CUDA接口cuCtxGetDevice获取当前上下文绑定的设备ID，打印日志确认

提示：如果调用avcodec_open2时传入了AVDictionary参数，函数返回后一定要检查字典内是否有残留键值，残留的内容都是解码器未识别的无效参数，需要及时修正参数名。

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