# v4l2h264dec

Source: [https://docs.qualcomm.com/doc/80-70015-50SC/topic/v4l2h264dec.html](https://docs.qualcomm.com/doc/80-70015-50SC/topic/v4l2h264dec.html)

v4l2h264dec 插件使用 V4L2 API 对视频流进行解码。

- 该插件使用 H264 视频解码器在支持的平台上提供硬件加速的 H.264（MPEG-4 第 10 部分）解码。
- 该插件基于 [GstVideoDecoder](https://gstreamer.freedesktop.org/documentation/video/gstvideodecoder.html) 基类。

## 继承链

[GObject](https://docs.gtk.org/gobject/) → [GstObject](https://gstreamer.freedesktop.org/documentation/gstreamer/gstobject.html?gi-language=c) → [GstElement](https://gstreamer.freedesktop.org/documentation/gstreamer/gstelement.html?gi-language=c) → [GstVideoDecoder](https://gstreamer.freedesktop.org/documentation/video/gstvideodecoder.html) → GstV4l2VideoDec → v4l2h264dec

下表提供了有关 v4l2h264dec 的接插口模板和组件属性的信息。有关用例信息，可参见[视频播放用例](https://docs.qualcomm.com/doc/80-70015-50SC/topic/video-playback-use-cases.html)。

## 接插口配置

| 接插口名称 | 处理能力 | 处理能力 | 处理能力 |
| --- | --- | --- | --- |
| SINK 模板：'sink'<br><ul class="ul" id="v4l2h264dec__ul_nn5_q3t_5zb"><br>                                    <li class="li"><em class="ph i">可用性：</em>总是</li><br><br>                                    <li class="li"><em class="ph i">方向：</em>接收设备</li><br><br>                                </ul> | video/x-h264 | 对准： | au |
| SINK 模板：'sink'<br><ul class="ul" id="v4l2h264dec__ul_nn5_q3t_5zb"><br>                                    <li class="li"><em class="ph i">可用性：</em>总是</li><br><br>                                    <li class="li"><em class="ph i">方向：</em>接收设备</li><br><br>                                </ul> | video/x-h264 | stream-format: | 字节流 |
| SINK 模板：'sink'<br><ul class="ul" id="v4l2h264dec__ul_nn5_q3t_5zb"><br>                                    <li class="li"><em class="ph i">可用性：</em>总是</li><br><br>                                    <li class="li"><em class="ph i">方向：</em>接收设备</li><br><br>                                </ul> | video/x-h264 | 级别： | { (string)1, (string)1b, (string)1.1, (string)1.2, (string)1.3, (string)2, (string)2.1, (string)2.2, (string)3, (string)3.1, (string)3.2, (string)4, (string)4.1, (string)4.2, (string)5, (string)5.1 } |
| SINK 模板：'sink'<br><ul class="ul" id="v4l2h264dec__ul_nn5_q3t_5zb"><br>                                    <li class="li"><em class="ph i">可用性：</em>总是</li><br><br>                                    <li class="li"><em class="ph i">方向：</em>接收设备</li><br><br>                                </ul> | video/x-h264 | 配置文件： | { (string)baseline, (string)constrained-baseline, (string)main, (string)high, (string)constrained-high } |
| SRC 模板：'src'<br><ul class="ul" id="v4l2h264dec__ul_on5_q3t_5zb"><br>                                    <li class="li"><em class="ph i">可用性：</em>总是</li><br><br>                                    <li class="li"><em class="ph i">方向：</em>源</li><br><br>                                </ul> | video/x-raw | 格式： | { (string)NV12, (string)NV21 } |
| SRC 模板：'src'<br><ul class="ul" id="v4l2h264dec__ul_on5_q3t_5zb"><br>                                    <li class="li"><em class="ph i">可用性：</em>总是</li><br><br>                                    <li class="li"><em class="ph i">方向：</em>源</li><br><br>                                </ul> | video/x-raw | 宽度： | [ 1, 32768 ] |
| SRC 模板：'src'<br><ul class="ul" id="v4l2h264dec__ul_on5_q3t_5zb"><br>                                    <li class="li"><em class="ph i">可用性：</em>总是</li><br><br>                                    <li class="li"><em class="ph i">方向：</em>源</li><br><br>                                </ul> | video/x-raw | 高度： | [ 1, 32768 ] |
| SRC 模板：'src'<br><ul class="ul" id="v4l2h264dec__ul_on5_q3t_5zb"><br>                                    <li class="li"><em class="ph i">可用性：</em>总是</li><br><br>                                    <li class="li"><em class="ph i">方向：</em>源</li><br><br>                                </ul> | video/x-raw | 帧率： | [ 0/1, 2147483647/1 ] |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |

## 组件配置

Note: 就当前版本而言，在读写属性中，**(5): dmabuf-import - GST\_V4L2\_IO\_DMABUF\_IMPORT** 属性仅支持 **capture-io-mode** 和 **output-io-mode**。

Table : v4l2h264dec 的组件属性

| 属性 | 说明 |
| --- | --- |
| automatic-request-sync-point-flags： | 自动请求同步点时要使用的标志。<br><ul class="ul" id="v4l2h264dec__ul_rnl_s3t_5zb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li"><br>                                        <p class="p">标志 GstVideoDecoderRequestSyncPointFlags 默认值：0x00000003, "corrupt-output+discard-input"</p><ul class="ul" id="v4l2h264dec__ul_atw_m15_q1c"><br>                                            <li class="li">(0x00000001): discard-input - GST_VIDEO_DECODER_REQUEST_SYNC_POINT_DISCARD_INPUT</li><br><br>                                            <li class="li">(0x00000002): corrupt-output - GST_VIDEO_DECODER_REQUEST_SYNC_POINT_CORRUPT_OUTPUT</li><br><br>                                        </ul><br><br>                                    </li><br><br>                                </ul> |
| automatic-request-sync-points | 在需要时自动请求同步点。<br><ul class="ul" id="v4l2h264dec__ul_snl_s3t_5zb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">Boolean。默认值：false</li><br><br>                                </ul> |
| capture-io-mode | 采集 I/O 模式（匹配源接插口）。<br><ul class="ul" id="v4l2h264dec__ul_tnl_s3t_5zb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">枚举 "GstV4l2IOMode" 默认值：0, "auto"<ul class="ul" id="v4l2h264dec__ul_ifv_g15_q1c"><br>                                            <li class="li">(0)：auto - GST_V4L2_IO_AUTO</li><br><br>                                            <li class="li">(1): rw - GST_V4L2_IO_RW</li><br><br>                                            <li class="li">(2): mmap - GST_V4L2_IO_MMAP</li><br><br>                                            <li class="li">(3): userptr - GST_V4L2_IO_USERPTR</li><br><br>                                            <li class="li">(4): dmabuf - GST_V4L2_IO_DMABUF</li><br><br>                                            <li class="li">(5): dmabuf-import - GST_V4L2_IO_DMABUF_IMPORT</li><br><br>                                        </ul><br></li><br><br>                                </ul> |
| device | 设备位置。<br><ul class="ul" id="v4l2h264dec__ul_unl_s3t_5zb"><br>                                    <li class="li">标志：可读</li><br><br>                                    <li class="li">字符串。默认值："/dev/video0"</li><br><br>                                </ul> |
| device-fd | 设备的文件描述符。<br><ul class="ul" id="v4l2h264dec__ul_vnl_s3t_5zb"><br>                                    <li class="li">标志：可读</li><br><br>                                    <li class="li">整型。范围：-1 - 2147483647 默认值：-1</li><br><br>                                </ul> |
| device-name | 设备名称。<br><ul class="ul" id="v4l2h264dec__ul_wnl_s3t_5zb"><br>                                    <li class="li">标志：可读</li><br><br>                                    <li class="li">字符串。默认值：null</li><br><br>                                </ul> |
| discard-corrupted-frames | 丢弃标记为已损坏的帧，而不将其处理为输出。<br><ul class="ul" id="v4l2h264dec__ul_xnl_s3t_5zb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">Boolean。默认值：false</li><br><br>                                </ul> |
| extra-controls | 设备的额外 v4l2 控件 (CID)。<br><ul class="ul" id="v4l2h264dec__ul_ynl_s3t_5zb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">"GstStructure" 类型的装箱指针</li><br><br>                                </ul> |
| max-errors | 返回流程错误之前的最大连续解码器错误数。<br><ul class="ul" id="v4l2h264dec__ul_znl_s3t_5zb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">整型。范围：-1 - 2147483647 默认值： 10</li><br><br>                                </ul> |
| min-force-key-unit-interval | force-keyunit 请求之间的最小间隔（单位：纳秒）。<br><ul class="ul" id="v4l2h264dec__ul_a4l_s3t_5zb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">64 位无符号整型。范围：0 - 18446744073709551615 默认值：0</li><br><br>                                </ul> |
| name | 对象名称。<br><ul class="ul" id="v4l2h264dec__ul_b4l_s3t_5zb"><br>                                    <li class="li">标志：可读、可写，0x2000</li><br><br>                                    <li class="li">字符串。默认值： "v4l2h264dec0"</li><br><br>                                </ul> |
| output-io-mode | 输出侧 I/O 模式（匹配接收设备接插口）。<br><ul class="ul" id="v4l2h264dec__ul_c4l_s3t_5zb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li"><br>                                        <p class="p">枚举 "GstV4l2IOMode" 默认值：0, "auto"</p><ul class="ul" id="v4l2h264dec__ul_a1w_t3t_5zb"><br>                                            <li class="li">(0)：auto - GST_V4L2_IO_AUTO</li><br><br>                                            <li class="li">(1): rw - GST_V4L2_IO_RW</li><br><br>                                            <li class="li">(2): mmap - GST_V4L2_IO_MMAP</li><br><br>                                            <li class="li">(3): userptr - GST_V4L2_IO_USERPTR</li><br><br>                                            <li class="li">(4): dmabuf - GST_V4L2_IO_DMABUF</li><br><br>                                            <li class="li">(5): dmabuf-import - GST_V4L2_IO_DMABUF_IMPORT</li><br><br>                                        </ul><br><br>                                    </li><br><br>                                </ul> |
| parent | 对象的父级。<br><ul class="ul" id="v4l2h264dec__ul_d4l_s3t_5zb"><br>                                    <li class="li">标志：可读、可写，0x2000</li><br><br>                                    <li class="li">"GstObject" 类型的对象</li><br><br>                                </ul> |
| qos | 处理下游的服务质量事件。<br><ul class="ul" id="v4l2h264dec__ul_e4l_s3t_5zb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">Boolean。默认值：true</li><br><br>                                </ul> |

**Parent Topic:** [显示、摄像头、编码和解码插件](https://docs.qualcomm.com/doc/80-70015-50SC/topic/display-plugins.html)

Last Published: Nov 11, 2025

[Previous Topic
qtisocketsrc](https://docs.qualcomm.com/bundle/publicresource/80-70015-50SC/topics/qtisocketsrc.md) [Next Topic
v4l2h265dec](https://docs.qualcomm.com/bundle/publicresource/80-70015-50SC/topics/v4l2h265dec.md)