FFmpeg: D3D12VADecodeContext Struct Reference

FFmpeg

D3D12VADecodeContext Struct Reference

This structure is used to provide the necessary configurations and data to the FFmpeg Direct3D 12 HWAccel implementation for video decoder. More...

#include <d3d12va_decode.h>

Data Fields

AVBufferRef * decoder_ref

ID3D12VideoDecoder * decoder

D3D12 video decoder. More...

ID3D12VideoDecoderHeap * decoder_heap

D3D12 video decoder heap. More...

D3D12_VIDEO_DECODE_CONFIGURATION cfg

D3D12 configuration used to create the decoder. More...

AVFifo * objects_queue

A cached queue for reusing the D3D12 command allocators and upload buffers. More...

ID3D12CommandQueue * command_queue

D3D12 command queue. More...

ID3D12VideoDecodeCommandList * command_list

D3D12 video decode command list. More...

ID3D12Resource ** ref_resources

The array of resources used for reference frames. More...

UINT * ref_subresources

The array of subresources used for reference frames. More...

UINT max_num_ref

Maximum number of reference frames. More...

UINT used_mask

Used mask used to record reference frames indices. More...

UINT bitstream_size

Bitstream size for each frame. More...

AVD3D12VASyncContext sync_ctx

The sync context used to sync command queue. More...

AVD3D12VADeviceContext * device_ctx

A pointer to AVD3D12VADeviceContext used to create D3D12 objects. More...

enum AVPixelFormat pix_fmt

Pixel format. More...

unsigned report_id

Private to the FFmpeg AVHWAccel implementation. More...

void * reference_only_map

The Reference-Only feature in DirectX 12 is a memory optimization technique designed for video decoding/encoding scenarios. More...

ID3D12Resource ** ref_only_resources

Detailed Description

This structure is used to provide the necessary configurations and data to the FFmpeg Direct3D 12 HWAccel implementation for video decoder.

Definition at line 37 of file d3d12va_decode.h.

Field Documentation

◆ decoder_ref

AVBufferRef* D3D12VADecodeContext::decoder_ref

Definition at line 38 of file d3d12va_decode.h.

◆ decoder

ID3D12VideoDecoder* D3D12VADecodeContext::decoder

D3D12 video decoder.

Definition at line 43 of file d3d12va_decode.h.

◆ decoder_heap

ID3D12VideoDecoderHeap* D3D12VADecodeContext::decoder_heap

D3D12 video decoder heap.

Definition at line 48 of file d3d12va_decode.h.

◆ cfg

D3D12_VIDEO_DECODE_CONFIGURATION D3D12VADecodeContext::cfg

D3D12 configuration used to create the decoder.

Specified by decoders

Definition at line 55 of file d3d12va_decode.h.

◆ objects_queue

AVFifo* D3D12VADecodeContext::objects_queue

A cached queue for reusing the D3D12 command allocators and upload buffers.

See also: https://learn.microsoft.com/en-us/windows/win32/direct3d12/recording-command-lists-and-bundles#id3d12commandallocator

Definition at line 62 of file d3d12va_decode.h.

◆ command_queue

ID3D12CommandQueue* D3D12VADecodeContext::command_queue

D3D12 command queue.

Definition at line 67 of file d3d12va_decode.h.

◆ command_list

ID3D12VideoDecodeCommandList* D3D12VADecodeContext::command_list

D3D12 video decode command list.

Definition at line 72 of file d3d12va_decode.h.

◆ ref_resources

ID3D12Resource** D3D12VADecodeContext::ref_resources

The array of resources used for reference frames.

The ref_resources.length is the same as D3D12VADecodeContext.max_num_ref

Definition at line 79 of file d3d12va_decode.h.

◆ ref_subresources

UINT* D3D12VADecodeContext::ref_subresources

The array of subresources used for reference frames.

The ref_subresources.length is the same as D3D12VADecodeContext.max_num_ref

Definition at line 86 of file d3d12va_decode.h.

◆ max_num_ref

UINT D3D12VADecodeContext::max_num_ref

Maximum number of reference frames.

Definition at line 91 of file d3d12va_decode.h.

◆ used_mask

UINT D3D12VADecodeContext::used_mask

Used mask used to record reference frames indices.

Definition at line 96 of file d3d12va_decode.h.

◆ bitstream_size

UINT D3D12VADecodeContext::bitstream_size

Bitstream size for each frame.

Definition at line 101 of file d3d12va_decode.h.

◆ sync_ctx

AVD3D12VASyncContext D3D12VADecodeContext::sync_ctx

The sync context used to sync command queue.

Definition at line 106 of file d3d12va_decode.h.

◆ device_ctx

AVD3D12VADeviceContext* D3D12VADecodeContext::device_ctx

A pointer to AVD3D12VADeviceContext used to create D3D12 objects.

Definition at line 111 of file d3d12va_decode.h.

◆ pix_fmt

enum AVPixelFormat D3D12VADecodeContext::pix_fmt

Pixel format.

Definition at line 116 of file d3d12va_decode.h.

◆ report_id

unsigned D3D12VADecodeContext::report_id

Private to the FFmpeg AVHWAccel implementation.

Definition at line 121 of file d3d12va_decode.h.

◆ reference_only_map

void* D3D12VADecodeContext::reference_only_map

The Reference-Only feature in DirectX 12 is a memory optimization technique designed for video decoding/encoding scenarios.

This feature requires that reference resources must be allocated with the D3D12_RESOURCE_FLAG_VIDEO_DECODE_REFERENCE_ONLY resource flag. Reference textures must also be separated from output textures. reference_only_map used as a storage for reference only frames ref_only_resources used as a shadow for ref_resources

Definition at line 132 of file d3d12va_decode.h.

◆ ref_only_resources

ID3D12Resource** D3D12VADecodeContext::ref_only_resources

Definition at line 133 of file d3d12va_decode.h.

The documentation for this struct was generated from the following file:

libavcodec/d3d12va_decode.h

Generated on Wed Nov 19 2025 19:24:09 for FFmpeg by doxygen 1.8.17