D3D12_VIDEO_DECODE_REFERENCE_FRAMES structure (d3d12video.h)

Contains the list of reference frames for the current decode operation. Either a texture array or an array of textures can be specified.

Syntax

typedef struct D3D12_VIDEO_DECODE_REFERENCE_FRAMES {
  UINT                   NumTexture2Ds;
  ID3D12Resource         **ppTexture2Ds;
  UINT                   *pSubresources;
  ID3D12VideoDecoderHeap **ppHeaps;
} D3D12_VIDEO_DECODE_REFERENCE_FRAMES;

Members

NumTexture2Ds

The number of references specified in the ppTexture2Ds field.

ppTexture2Ds

A list of reference textures. When specifying texture arrays, each entry will be point to the same resource. When specifying an array of textures, each entry will point to a separate resource.

pSubresources

An array of subresource indices for the reference textures specified in ppTexture2Ds. NULL indicates that subresource 0 should be assumed for each resource.

With texture arrays within a single resource, the subresource indices point to the array index of the first resource plane. With an array of textures in individual resources, the subresource index is typically zero.

The video device driver uses the "PicEntry" indices defined in the DXVA spec for the codec to dereference this array to find the subresource index to use with the corresponding resource. For example, in HEVC, the Driver uses DXVA_PicEntry_HEVC::Index7Bits as an index for this array.

ppHeaps

An array of ID3D12VideoDecoderHeap objects. This field is used with formats that support non-key frame resolution changes, allowing the caller to pass in the previous resolution's heap, relative to the reference it's being used for, in addition to the current resolution heap.

Remarks

Reference textures may have limitations such as a requirement to allocate reference buffers as a texture array. For information on the requirements for different decoder configurations, see D3D12_VIDEO_DECODE_TIER.

Requirements

Requirement	Value
Header	d3d12video.h