D3D12DDIARG_CREATE_VIDEO_DECODER structure

Used to create a decoder object for a decode session.

Syntax

typedef struct D3D12DDIARG_CREATE_VIDEO_DECODER {
  UINT                                NodeMask;
  D3D12DDI_VIDEO_DECODE_CONFIGURATION Configuration;
  UINT                                DecodeWidth;
  UINT                                DecodeHeight;
  UINT                                MaxDecodePictureBufferCount;
  DXGI_RATIONAL                       FrameRate;
  UINT                                Bitrate;
  D3D12DDI_VIDEO_USAGE                Usage;
} D3D12DDIARG_CREATE_VIDEO_DECODER;

Members

  • NodeMask
    A node mask. For single GPU operation, set this value to zero (0). If there are multiple GPU nodes, set a bit to identify the physical adapter of the device to which the command queue applies. Each bit in the mask corresponds to a single node. Only one bit may be set.

  • Configuration
    The decode profile and bitstream encryption. For more information, see the D3D12DDI_VIDEO_DECODE_CONFIGURATION enumeration.

  • DecodeWidth
    The decode width of the bitstream to be decoded.

  • DecodeHeight
    The decode height of the bitstream to be decoded.

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

  • FrameRate
    The frame rate of the input video stream.

  • Bitrate
    The data compression rate, in bits per second, for the compressed video stream.

  • Usage
    A hint for the intended usage for the decoder stream. For more information, see the D3D12DDI_VIDEO_USAGE enumeration.

Remarks

Drivers can use the Bitrate and FrameRate parameters to inform heuristics such as intermediate allocation sizes or performance optimizations.

Decoding a frame is allowed to 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 a status of 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. They are not allowed to fail with D3D12DDI_VIDEO_DECODE_STATUS_RATE_EXCEEDED.

Requirements

Header

D3d12umddi.h (include D3d12umddi.h)

See also

D3D12DDI_VIDEO_DECODE_CONFIGURATION

D3D12DDI_VIDEO_USAGE

 

 

Send comments about this topic to Microsoft