D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264结构 （d3d12video.h）

表示 H.264 编码的关联 EncodeFrame 命令的图片级别控件元素。

Syntax

typedef struct D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264 {
  D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_FLAGS                                         Flags;
  D3D12_VIDEO_ENCODER_FRAME_TYPE_H264                                                               FrameType;
  UINT                                                                                              pic_parameter_set_id;
  UINT                                                                                              idr_pic_id;
  UINT                                                                                              PictureOrderCountNumber;
  UINT                                                                                              FrameDecodingOrderNumber;
  UINT                                                                                              TemporalLayerIndex;
  UINT                                                                                              List0ReferenceFramesCount;
  UINT                                                                                              *pList0ReferenceFrames;
  UINT                                                                                              List1ReferenceFramesCount;
  UINT                                                                                              *pList1ReferenceFrames;
  UINT                                                                                              ReferenceFramesReconPictureDescriptorsCount;
  D3D12_VIDEO_ENCODER_REFERENCE_PICTURE_DESCRIPTOR_H264                                             *pReferenceFramesReconPictureDescriptors;
  UCHAR                                                                                             adaptive_ref_pic_marking_mode_flag;
  UINT                                                                                              RefPicMarkingOperationsCommandsCount;
  D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_REFERENCE_PICTURE_MARKING_OPERATION           *pRefPicMarkingOperationsCommands;
  UINT                                                                                              List0RefPicModificationsCount;
  D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_REFERENCE_PICTURE_LIST_MODIFICATION_OPERATION *pList0RefPicModifications;
  UINT                                                                                              List1RefPicModificationsCount;
  D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_REFERENCE_PICTURE_LIST_MODIFICATION_OPERATION *pList1RefPicModifications;
  UINT                                                                                              QPMapValuesCount;
  INT8                                                                                              *pRateControlQPMap;
} D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264;

Members

Flags

D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_FLAGS枚举中的值的按位 OR 组合，指定所编码帧的配置标志。

FrameType

指定图片类型的 D3D12_VIDEO_ENCODER_FRAME_TYPE_H264 枚举中的值。 确保编解码器特定的标志支持指定的类型。 此选择必须与主机设置的 GOP 结构配置保持同步。 请注意，GOP 按显示顺序定义，此图片类型选择必须遵循 GOP，但按编码顺序定义。

pic_parameter_set_id

一个 UINT ，指定要在当前帧的切片标头中使用的值来引用 PPS。

idr_pic_id

当 FrameTypeD3D12_VIDEO_ENCODER_FRAME_TYPE_H264_IDR_FRAME时，一个 UINT，指示要用于帧中所有切片标头中要使用的一个 UINT 帧的标识符。

PictureOrderCountNumber

指定当前帧显示顺序的 UINT 。

FrameDecodingOrderNumber

一个 UINT ，它用语义指定帧解码顺序，如切片标头frame_num语法元素所指示，该元素在每个引用图片后递增。

TemporalLayerIndex

指定临时层次结构中的图片层编号的 UINT 。 检查 D3D12_VIDEO_ENCODER_CODEC_CONFIGURATION_SUPPORT_H264中的最大层数。

List0ReferenceFramesCount

一个 UINT ，用于指定要用于此帧的过去帧引用数。 此值应与 D3D12_VIDEO_ENCODER_CODEC_CONFIGURATION_SUPPORT_H264中公开的内容一致。

pList0ReferenceFrames

指向 UINT 数组的指针，该数组指定要用于此帧的过去帧引用帧的列表。 此数组中的每个整数值都索引到 pReferenceFramesReconPictureDescriptors 中，以引用 DPB 中保留的图片。

List1ReferenceFramesCount

一个 UINT ，用于指定要用于此帧的未来帧引用数。 此值应与 D3D12_VIDEO_ENCODER_CODEC_CONFIGURATION_SUPPORT_H264中公开的内容一致。

pList1ReferenceFrames

指向 UINT 数组的指针，该数组指定要用于此帧的未来帧引用帧的列表。 此数组中的每个整数值都索引到 pReferenceFramesReconPictureDescriptors 中，以引用 DPB 中保留的图片。

ReferenceFramesReconPictureDescriptorsCount

一个 UINT ，用于指定 pReferenceFramesReconPictureDescriptors 中的条目数。

pReferenceFramesReconPictureDescriptors

指向 UINT 数组的指针，该数组描述D3D12_VIDEO_ENCODER_PICTURE_CONTROL_DESC中保留的 DPB 缓冲区的当前状态 。ReferenceFrames。 pList0ReferenceFrames 和 pList1ReferenceFrames 列出了从过去/将来引用到此描述符数组中的索引映射。

此描述符数组反过来会将此帧的参考图片映射到重建的图片数组中的资源索引 D3D12_VIDEO_ENCODER_PICTURE_CONTROL_DESC。ReferenceFrames。 此外，对于每个参考图片，它指示编码和显示顺序号以及它是否是长期引用。

此数组的大小始终与D3D12_VIDEO_ENCODER_PICTURE_CONTROL_DESC匹配。关联的 EncodeFrame 命令的 ReferenceFrames.NumTextures。

adaptive_ref_pic_marking_mode_flag

为帧引用处理定义语义模式的 UCHAR 。

RefPicMarkingOperationsCommandsCount

一个 UINT ，指定与当前帧关联的引用图片标记作的数目。 要求 adaptive_ref_pic_marking_mode_flag 设置为 1。

pRefPicMarkingOperationsCommands

指向 D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_REFERENCE_PICTURE_MARKING_OPERATION 结构的数组的指针，该数组表示与当前帧关联的引用图片标记作的列表。 此列表描述的作需要在编码会话期间相应地反映在 DPB 描述符中。

List0RefPicModificationsCount

一个 UINT ，用于指定 pList0RefPicModifications 中的项数。

pList0RefPicModifications

指向 D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_REFERENCE_PICTURE_LIST_MODIFICATION_OPERATION 结构的数组的指针，该数组表示 pList0ReferenceFrames 列表的引用图片列表修改作的列表。

List1RefPicModificationsCount

一个 UINT ，用于指定 pList1RefPicModifications 中的项数。

pList1RefPicModifications

指向 D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_REFERENCE_PICTURE_LIST_MODIFICATION_OPERATION 结构的数组的指针，该数组表示 pList1ReferenceFrames 列表的引用图片列表修改作的列表。

QPMapValuesCount

一个 UINT ，用于指定 pRateControlQPMap 中存在的元素数。 这应与帧中的编码块数匹配，将帧分辨率舍入到最接近的对齐值。

pRateControlQPMap

指向 Int8 数组的指针，它以行/列扫描顺序表示，QP 映射值，用于此帧的每个平方区域。 可以使用当前分辨率和D3D12_FEATURE_DATA_VIDEO_ENCODER_RESOLUTION_SUPPORT_LIMITS计算 QP 地图维度 。QPMapRegionPixelsSize 传达平方区域大小。

注解

请注意，如果当前帧被标记为引用图片，则输出必须包含重新构造的图片以及主机的位流，才能将其放置在重建的图片引用列表中的未来命令中。 请注意，某些帧类型在设置这些值之前，可能会有限制标记为引用，请检查功能支持。

下表列出了 H264 编码的预期 SPS 和 PPS 值。

H264 的Level_idc映射

H264 序列参数集预期值

H264 图片参数集预期值

要求