D3D12DDIARG_CREATE_VIDEO_DECODER_HEAP_0072 structure (d3d12umddi.h)

Structure used to create a video decoder heap for a decode session.

Syntax

typedef struct D3D12DDIARG_CREATE_VIDEO_DECODER_HEAP_0072 {
  UINT                                     NodeMask;
  D3D12DDI_VIDEO_DECODE_CONFIGURATION_0020 Configuration;
  UINT                                     DecodeWidth;
  UINT                                     DecodeHeight;
  DXGI_FORMAT                              Format;
  DXGI_RATIONAL                            FrameRate;
  UINT                                     BitRate;
  UINT                                     MaxDecodePictureBufferCount;
  D3D12DDI_HPROTECTEDRESOURCESESSION_0030  hDrvProtectedResourceSession;
} D3D12DDIARG_CREATE_VIDEO_DECODER_HEAP_0072;

Members

NodeMask

Represents the set of nodes. For single GPU operation, set this to zero. If there are multiple GPU nodes, set a bit to identify the node (the device's physical adapter) to which the command queue applies. Each bit in the mask corresponds to a single node. Only 1 bit may be set.

Configuration

The decode profile and bitstream encryption. See D3D12DDI_VIDEO_DECODE_CONFIGURATION.

DecodeWidth

The width of the bitstream to be decoded.

DecodeHeight

The height of the bitstream to be decoded.

Format

The resource data format.

FrameRate

The frame rate of the input video stream.

BitRate

The bits per second data compression rate for the compressed video stream.

MaxDecodePictureBufferCount

The maximum number of decode picture buffers this stream can have.

hDrvProtectedResourceSession

Handle to the protected resource session acquired at object creation time.

Remarks

The decoder heap holds the allocations for a decode session, and may contain state including reference related data such as motion vectors. In the event of a resolution change or a MaxDecodePictureBufferCount change, a new instance of this object is created. It is codec specific when these properties can change.

The decode width and height specify the native stream resolution before any scale. The maximum Decode Picture Buffer (DPB) count specifies the largest DPB count that can be used without recreating the video decode stream.

The Bitrate and FrameRate parameters may be used by drivers to inform heuristics such as intermediate allocation sizes or performance optimizations.

Decoding a frame can fail if the Bitrate and FrameRate values are insufficient for the video stream. If decode fails for this reason, the query D3D12DDI_QUERY_TYPE_VIDEO_DECODE_STATISTICS must return Status D3D12DDI_VIDEO_DECODE_STATUS_RATE_EXCEEDED.

The Bitrate and FrameRate parameters may also be set to zero. When these values are used, drivers must make worst case assumptions and are not allowed to fail with D3D12DDI_VIDEO_DECODE_STATUS_RATE_EXCEEDED.

See the D3D Video Protected Resource Support Specification for more information.

Requirements

See also

D3D12DDI_VIDEO_DECODE_CONFIGURATION