# v4l2h265enc

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

v4l2h265enc 插件使用 V4L2 API 对视频流进行编码。

- 该插件使用 H.265 视频编码器在支持的平台上提供硬件加速的 H.265 (MPEG-H 第 2 部分) 编码
- 该插件基于 [GstVideoEncoder](https://gstreamer.freedesktop.org/documentation/video/gstvideoencoder.html?gi-language=c) 基类。

## 继承链

[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) → [GstVideoEncoder](https://gstreamer.freedesktop.org/documentation/video/gstvideoencoder.html?gi-language=c) → GstV4l2VideoEnc → v4l2h265enc

下表提供了有关 v4l2h265enc 的端口模板和组件属性的信息。有关用例信息，请参见[视频编码](https://docs.qualcomm.com/doc/80-70017-50SC/topic/camera-and-video-encode.html)和[基于切片的编码](https://docs.qualcomm.com/doc/80-70017-50SC/topic/camera-and-video-encode.html#slice-based-encoding)。

## 端口配置

| 端口名称 | 功能 | 功能 | 功能 |
| --- | --- | --- | --- |
| SINK 模板：'sink'<br><ul class="ul" id="v4l2h265enc__ul_wkg_csz_q1c"><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 | format： | { (string)NV12, (string)NV21 } |
| SINK 模板：'sink'<br><ul class="ul" id="v4l2h265enc__ul_wkg_csz_q1c"><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 | width: | [ 1, 32768 ] |
| SINK 模板：'sink'<br><ul class="ul" id="v4l2h265enc__ul_wkg_csz_q1c"><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 | height: | [ 1, 32768 ] |
| SINK 模板：'sink'<br><ul class="ul" id="v4l2h265enc__ul_wkg_csz_q1c"><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 | framerate： | [ 0/1, 2147483647/1 ] |
| SRC 模板：'src'<br><ul class="ul" id="v4l2h265enc__ul_xkg_csz_q1c"><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-h265 | alignment: | au |
| SRC 模板：'src'<br><ul class="ul" id="v4l2h265enc__ul_xkg_csz_q1c"><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-h265 | stream-format: | byte-stream |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |

## 组件配置

Table : v4l2h265enc 的组件属性

| 属性 | 说明 |
| --- | --- |
| capture-io-mode | 采集 I/O 模式（匹配 src 端口）<br><ul class="ul" id="v4l2h265enc__ul_jt5_2sz_q1c"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">枚举 “GstV4l2IOMode” 默认： 0，“auto”<ul class="ul" id="v4l2h265enc__ul_sdl_hsz_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><br>                                    </li><br><br>                                </ul> |
| device | 设备位置<br><ul class="ul" id="v4l2h265enc__ul_kt5_2sz_q1c"><br>                                    <li class="li">标志：可读</li><br><br>                                    <li class="li">字符串。默认：“/dev/video1”</li><br><br>                                </ul> |
| device-fd | 设备的文件描述符<br><ul class="ul" id="v4l2h265enc__ul_lt5_2sz_q1c"><br>                                    <li class="li">标志：可读</li><br><br>                                    <li class="li">整型。范围：-1 - 2147483647 默认值：-1</li><br><br>                                </ul> |
| device-name | 设备名称<br><ul class="ul" id="v4l2h265enc__ul_mt5_2sz_q1c"><br>                                    <li class="li">标志：可读</li><br><br>                                    <li class="li">字符串。默认值：null</li><br><br>                                </ul> |
| extra-controls | 设备的额外 v4l2 控件 (CID)<br><ul class="ul" id="v4l2h265enc__ul_nt5_2sz_q1c"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">"GstStructure" 类型的装箱指针</li><br><br>                                </ul> |
| min-force-key-unit-interval | force-keyunit 请求之间的最小间隔（单位：纳秒）<br><ul class="ul" id="v4l2h265enc__ul_ot5_2sz_q1c"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">64 位无符号整型。范围： 0~18446744073709551615 默认： 0</li><br><br>                                </ul> |
| name | 对象名称<br><ul class="ul" id="v4l2h265enc__ul_pt5_2sz_q1c"><br>                                    <li class="li">标志：可读、可写，0x2000</li><br><br>                                    <li class="li">字符串。默认：“v4l2h265enc0”</li><br><br>                                </ul> |
| output-io-mode | 输出侧 I/O 模式（匹配接收端）<br><ul class="ul" id="v4l2h265enc__ul_qt5_2sz_q1c"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li"><br>                                        <p class="p">枚举 “GstV4l2IOMode” 默认： 0，“auto”</p><ul class="ul" id="v4l2h265enc__ul_v2h_lsz_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><br>                                    </li><br><br>                                </ul> |
| parent | 对象的父级<br><ul class="ul" id="v4l2h265enc__ul_rt5_2sz_q1c"><br>                                    <li class="li">标志：可读、可写，0x2000</li><br><br>                                    <li class="li">"GstObject" 类型的对象</li><br><br>                                </ul> |
| qos | 处理下游的服务质量事件<br><ul class="ul" id="v4l2h265enc__ul_st5_2sz_q1c"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">Boolean。默认值：true</li><br><br>                                </ul> |

下表列出了 H.265 的编解码控件。有关常规 v4l2ctl 用户和编解码控件，请参见[表 :  3](https://docs.qualcomm.com/doc/80-70017-50SC/topic/v4l2h264enc.html#v4l2h264enc__table_ss2_ljc_fbc)和[表 :  4](https://docs.qualcomm.com/doc/80-70017-50SC/topic/v4l2h264enc.html#v4l2h264enc__table_o4d_tjc_fbc)。

Table : v4l2ctl – H.265 codec 控件

| 控件名称 | 控件类型 | 参数 |
| --- | --- | --- |
| hevc\_minimum\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_upk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=51</li><br><br>                                    <li class="li">step=1</li><br><br>                                    <li class="li">value=1；这是默认值</li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_maximum\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_vpk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=51</li><br><br>                                    <li class="li">step=1</li><br><br>                                    <li class="li">value=51；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_i\_frame\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_wpk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=51</li><br><br>                                    <li class="li">step=1</li><br><br>                                    <li class="li">value=20；这是默认值</li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_p\_frame\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_xpk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=51</li><br><br>                                    <li class="li">step=1</li><br><br>                                    <li class="li">value=20；这是默认值</li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_b\_frame\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_ypk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=51</li><br><br>                                    <li class="li">step=1</li><br><br>                                    <li class="li">value=20；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_hierarchical\_coding\_type | 菜单 | <ul class="ul" id="v4l2h265enc__ul_aqk_5kc_fbc"><br>                                    <li class="li">min=0 </li><br><br>                                    <li class="li">max=1 </li><br><br>                                    <li class="li">value=1 (P)<ul class="ul" id="v4l2h265enc__ul_zpk_5kc_fbc"><br>                                            <li class="li">0: B</li><br><br>                                            <li class="li">1：P；这是默认值</li><br><br>                                        </ul><br><br>                                    </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_hierarchical\_coding\_layer | 整型 | <ul class="ul" id="v4l2h265enc__ul_bqk_5kc_fbc"><br>                                    <li class="li">min=0</li><br><br>                                    <li class="li">max=5</li><br><br>                                    <li class="li">step=1</li><br><br>                                    <li class="li">value=0；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_profile | 菜单 | <ul class="ul" id="v4l2h265enc__ul_dqk_5kc_fbc"><br>                                    <li class="li">min=0</li><br><br>                                    <li class="li">max=2</li><br><br>                                    <li class="li">default=0</li><br><br>                                    <li class="li">value=0 (Main)<ul class="ul" id="v4l2h265enc__ul_cqk_5kc_fbc"><br>                                            <li class="li">0：Main；这是默认值</li><br><br>                                            <li class="li">1：主静态图</li><br><br>                                            <li class="li">2：主要 10</li><br><br>                                        </ul><br></li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_level | 菜单 | <ul class="ul" id="v4l2h265enc__ul_fqk_5kc_fbc"><br>                                    <li class="li">min=0 </li><br><br>                                    <li class="li">max=7</li><br><br>                                    <li class="li">value=7 (5)<ul class="ul" id="v4l2h265enc__ul_eqk_5kc_fbc"><br>                                            <li class="li">0:1</li><br><br>                                            <li class="li">1: 2</li><br><br>                                            <li class="li">2: 2.1</li><br><br>                                            <li class="li">3: 3</li><br><br>                                            <li class="li">4: 3.1</li><br><br>                                            <li class="li">5: 4</li><br><br>                                            <li class="li">6: 4.1</li><br><br>                                            <li class="li">7： 5；这是默认值</li><br><br>                                        </ul><br></li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_hierarchical\_lay\_0\_bitrate | 整型 | <ul class="ul" id="v4l2h265enc__ul_gqk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=100000000 </li><br><br>                                    <li class="li">step=1</li><br><br>                                    <li class="li">value=20000000；这是默认值</li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_hierarchical\_lay\_1\_bitrate | 整型 | <ul class="ul" id="v4l2h265enc__ul_hqk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=100000000</li><br><br>                                    <li class="li">step=1 </li><br><br>                                    <li class="li">value=20000000；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_hierarchical\_lay\_2\_bitrate | 整型 | <ul class="ul" id="v4l2h265enc__ul_iqk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=100000000</li><br><br>                                    <li class="li">step=1</li><br><br>                                    <li class="li">value=20000000；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_hierarchical\_lay\_3\_bitrate | 整型 | <ul class="ul" id="v4l2h265enc__ul_jqk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=100000000</li><br><br>                                    <li class="li">step=1</li><br><br>                                    <li class="li">value=20000000；这是默认值</li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_hierarchical\_lay\_4\_bitrate | 整型 | <ul class="ul" id="v4l2h265enc__ul_kqk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=100000000</li><br><br>                                    <li class="li">step=1 </li><br><br>                                    <li class="li">value=20000000；这是默认值</li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_hierarchical\_lay\_5\_bitrate | 整型 | <ul class="ul" id="v4l2h265enc__ul_lqk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=100000000</li><br><br>                                    <li class="li">step=1 </li><br><br>                                    <li class="li">value=20000000；这是默认值</li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_i\_frame\_minimum\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_mqk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=51</li><br><br>                                    <li class="li">step=1 </li><br><br>                                    <li class="li">value=1；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_i\_frame\_maximum\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_nqk_5kc_fbc"><br>                                    <li class="li">min=1 </li><br><br>                                    <li class="li">max=51 </li><br><br>                                    <li class="li">step=1 </li><br><br>                                    <li class="li">value=51；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_p\_frame\_minimum\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_oqk_5kc_fbc"><br>                                    <li class="li">min=1 </li><br><br>                                    <li class="li">max=51 </li><br><br>                                    <li class="li">step=1 </li><br><br>                                    <li class="li">value=1；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_p\_frame\_maximum\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_pqk_5kc_fbc"><br>                                    <li class="li">min=1</li><br><br>                                    <li class="li">max=51 </li><br><br>                                    <li class="li">step=1 </li><br><br>                                    <li class="li">value=51；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_b\_frame\_minimum\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_qqk_5kc_fbc"><br>                                    <li class="li">min=1 </li><br><br>                                    <li class="li">max=51 </li><br><br>                                    <li class="li">step=1 </li><br><br>                                    <li class="li">value=1；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |
| hevc\_b\_frame\_maximum\_qp\_value | 整型 | <ul class="ul" id="v4l2h265enc__ul_rqk_5kc_fbc"><br>                                    <li class="li">min=1 </li><br><br>                                    <li class="li">max=51 </li><br><br>                                    <li class="li">step=1 </li><br><br>                                    <li class="li">value=51；这是默认值 </li><br><br>                                    <li class="li">flags=execute-on-write</li><br><br>                                </ul> |

**上一级主题：** [显示、摄像头、编码和解码插件](https://docs.qualcomm.com/doc/80-70017-50SC/topic/display-plugins.html)

Last Published: Nov 11, 2025

[Previous Topic
v4l2h264enc](https://docs.qualcomm.com/bundle/publicresource/80-70017-50SC/topics/v4l2h264enc.md) [Next Topic
v4l2vp9dec](https://docs.qualcomm.com/bundle/publicresource/80-70017-50SC/topics/v4l2vp9dec.md)