estrutura D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264 (d3d12video.h)

Representa os elementos de controle de nível de imagem para o comando EncodeFrame associado para codificação H.264.

Sintaxe

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

Uma combinação OR bit a bit de valores da enumeração D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_FLAGS especificando sinalizadores de configuração para o quadro que está sendo codificado.

FrameType

Um valor da enumeração D3D12_VIDEO_ENCODER_FRAME_TYPE_H264 especificando o tipo de imagem. Verifique se os sinalizadores específicos do codec dão suporte ao tipo especificado. Essa seleção deve ser mantida em sincronia com a configuração da estrutura GOP definida pelo host. Observe que o GOP é definido na ordem de exibição e essa seleção de tipo de imagem deve seguir o GOP, mas em ordem de codificação.

pic_parameter_set_id

Um UINT que especifica o valor a ser usado nos cabeçalhos de fatia do quadro atual para fazer referência ao PPS.

idr_pic_id

Quando FrameType é D3D12_VIDEO_ENCODER_FRAME_TYPE_H264_IDR_FRAME, um UINT indicando o identificador do quadro IDR a ser usado em todos os cabeçalhos de fatias presentes no quadro.

PictureOrderCountNumber

Um UINT que especifica a ordem de exibição do quadro atual.

FrameDecodingOrderNumber

Um UINT que especifica a ordem de decodificação de quadro com semântica, conforme indicado pelo cabeçalho de fatia frame_num elemento de sintaxe que incrementa após cada imagem de referência.

TemporalLayerIndex

Um UINT que especifica o número da camada de imagem na hierarquia temporal. Verifique o número máximo de camadas em D3D12_VIDEO_ENCODER_CODEC_CONFIGURATION_SUPPORT_H264.

List0ReferenceFramesCount

Um UINT que especifica o número de referências de quadros anteriores a serem usadas para esse quadro. Esse valor deve ser coerente com o que foi exposto em D3D12_VIDEO_ENCODER_CODEC_CONFIGURATION_SUPPORT_H264.

pList0ReferenceFrames

Um ponteiro para uma matriz UINT especificando a lista de quadros de referência de quadros anteriores a serem usados para esse quadro. Cada valor inteiro nesta matriz indicia em pReferenceFramesReconPictureDescriptors para referenciar imagens mantidas no DPB.

List1ReferenceFramesCount

Um UINT que especifica o número de referências futuras de quadro a serem usadas para esse quadro. Esse valor deve ser coerente com o que foi exposto em D3D12_VIDEO_ENCODER_CODEC_CONFIGURATION_SUPPORT_H264.

pList1ReferenceFrames

Um ponteiro para uma matriz UINT especificando a lista de quadros de referência de quadro futuros a serem usados para esse quadro. Cada valor inteiro nesta matriz indicia em pReferenceFramesReconPictureDescriptors para referenciar imagens mantidas no DPB.

ReferenceFramesReconPictureDescriptorsCount

Um UINT que especifica o número de entradas em pReferenceFramesReconPictureDescriptors.

pReferenceFramesReconPictureDescriptors

Um ponteiro para uma matriz UINT que descreve o estado atual do buffer DPB mantido em D3D12_VIDEO_ENCODER_PICTURE_CONTROL_DESC. ReferenceFrames. O pList0ReferenceFrames e pList1ReferenceFrames listam o mapa de índices de referências passadas/futuras nessa matriz de descritores.

Essa matriz de descritores, por sua vez, mapeia uma imagem de referência para esse quadro em um índice de recursos na matriz de imagens reconstruídas D3D12_VIDEO_ENCODER_PICTURE_CONTROL_DESC. ReferenceFrames. Além disso, para cada imagem de referência, ela indica o número da ordem de codificação e exibição e se é uma referência de longo prazo.

O tamanho dessa matriz sempre corresponde D3D12_VIDEO_ENCODER_PICTURE_CONTROL_DESC. ReferenceFrames.NumTextures para o comando EncodeFrame associado.

adaptive_ref_pic_marking_mode_flag

Um UCHAR que define um modo semântico para o tratamento de referência de quadro.

RefPicMarkingOperationsCommandsCount

Um UINT que especifica o número de operações de marcação de imagens de referência associadas ao quadro atual. Requer que adaptive_ref_pic_marking_mode_flag esteja definido como 1.

pRefPicMarkingOperationsCommands

Um ponteiro para uma matriz de estruturas D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_REFERENCE_PICTURE_MARKING_OPERATION que representam a lista de operações de marcação de imagens de referência associadas ao quadro atual. As operações descritas por essa lista precisam ser refletidas nos descritores DPB adequadamente durante a sessão de codificação.

List0RefPicModificationsCount

Um UINT que especifica o número de itens em pList0RefPicModifications.

pList0RefPicModifications

Um ponteiro para uma matriz de estruturas de D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_REFERENCE_PICTURE_LIST_MODIFICATION_OPERATION que representam a lista de operações de modificação da lista de imagens de referência para a lista pList0ReferenceFrames .

List1RefPicModificationsCount

Um UINT que especifica o número de itens em pList1RefPicModifications.

pList1RefPicModifications

Um ponteiro para uma matriz de estruturas de D3D12_VIDEO_ENCODER_PICTURE_CONTROL_CODEC_DATA_H264_REFERENCE_PICTURE_LIST_MODIFICATION_OPERATION que representam a lista de operações de modificação da lista de imagens de referência para a lista pList1ReferenceFrames .

QPMapValuesCount

Um UINT que especifica o número de elementos presentes em pRateControlQPMap. Isso deve corresponder ao número de blocos de codificação no quadro, arredondando a resolução do quadro para os valores alinhados mais próximos.

pRateControlQPMap

Um ponteiro para uma matriz de Int8 que contém, na ordem de verificação de linha/coluna, os valores de mapa de QP a serem usados em cada região quadrada para esse quadro. As dimensões do mapa de QP podem ser calculadas usando a resolução atual e D3D12_FEATURE_DATA_VIDEO_ENCODER_RESOLUTION_SUPPORT_LIMITS. QPMapRegionPixelsSize que transmite os tamanhos de região quadrada.

Observações

Observe que, se o quadro atual estiver marcado como uma imagem de referência, a saída deverá conter a imagem reconstruída juntamente com o bitstream para que o host a coloque em comandos futuros na lista de referência de imagens reconstruídas. Observe que pode haver limitações para que alguns tipos de quadro sejam marcados como referências, verifique o suporte ao recurso antes de definir esses valores.

As tabelas a seguir listam os valores de SPS e PPS esperados para codificação H264.

mapeamentos de Level_idc para H264

Valores esperados do conjunto de parâmetros de sequência H264

Valores esperados do Conjunto de Parâmetros de Imagem H264

Requirements