[FFmpeg-cvslog] doc/ffmpeg: update the documentation about vaapi device creation

[Haihao Xiang]

ffmpeg | branch: master | Haihao Xiang <haihao.xiang at intel.com> | Tue Jan 16 13:23:11 2024 +0800| [6e4d85a94ef05655f22a86317a44a42d1ae22d61] | committer: Stefano Sabatini

doc/ffmpeg: update the documentation about vaapi device creation

Signed-off-by: Haihao Xiang <haihao.xiang at intel.com>

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=6e4d85a94ef05655f22a86317a44a42d1ae22d61
---

 doc/ffmpeg.texi | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index f034b7d4a2..5a214dd139 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -1379,6 +1379,29 @@ If not specified, it will attempt to open the default X11 display (@emph{$DISPLA
 and then the first DRM render node (@emph{/dev/dri/renderD128}), or the default
 DirectX adapter on Windows.
 
+The following options are recognized:
+ at table @option
+ at item kernel_driver
+When @var{device} is not specified, use this option to specify the name of the kernel
+driver associated with the desired device. This option is available only when
+the hardware acceleration method @emph{drm} and @emph{vaapi} are enabled.
+ at end table
+
+Examples:
+ at table @emph
+ at item -init_hw_device vaapi
+Create a vaapi device on the default device.
+
+ at item -init_hw_device vaapi:/dev/dri/renderD129
+Create a vaapi device on DRM render node @file{/dev/dri/renderD129}.
+
+ at item -init_hw_device vaapi:1
+Create a vaapi device on DirectX adapter 1.
+
+ at item -init_hw_device vaapi:,kernel_driver=i915
+Create a vaapi device on a device associated with kernel driver @samp{i915}.
+ at end table
+
 @item vdpau
 @var{device} is an X11 display name.
 If not specified, it will attempt to open the default X11 display (@emph{$DISPLAY}).