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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 2004 |
| Header | d3d12umddi.h |