WSL2中Intel QSV初始化失败求助：已安装同Ubuntu原生库仍无法使用

前提条件 #

• Windows版本需为**Windows 11 22H2+**或Windows 10 21H2+，WSL2内核版本≥5.10.60.1
• CPU确认支持QSV，且Windows端已安装最新Intel核显驱动

步骤1：配置WSL2 GPU直通 #

1. 打开Windows终端（管理员权限），执行命令更新WSL内核以启用GPU支持：

   wsl --update
   

2. 编辑WSL配置文件/etc/wsl.conf，添加以下内容启用systemd（部分环境依赖）：

   [boot]
   systemd=true
   

   保存后执行wsl --shutdown重启WSL生效。

步骤2：修复VA-API环境与驱动 #

1. 运行vainfo前设置正确的环境变量，无需依赖X11/Wayland：

   export LIBVA_DRIVER_NAME=iHD
   export DISPLAY=:0
   export XDG_RUNTIME_DIR=/run/user/$(id -u)
   

2. 卸载原生Ubuntu驱动包，安装适配WSL的Intel媒体驱动：

   sudo apt remove --purge intel-media-driver libva2 vainfo
   sudo apt install intel-media-va-driver-non-free libva2 vainfo
   

步骤3：验证QSV初始化 #

执行以下命令测试VA-API是否正常工作：

vainfo --display drm --device /dev/dri/renderD128

若成功，会输出VA-API支持的编码/解码profile及entrypoint，说明QSV初始化完成。

C语言调用QSV注意事项 #

• 代码中指定DRM设备路径为/dev/dri/renderD128
• 初始化VA-API时使用VA_DISPLAY_DRM方式，而非X11/Wayland显示接口
• 编译链接时需包含-lva -lva-drm -lmfx等依赖库

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