DXVA_PicParams_AV1 structure (dxva.h)
The DXVA_PicParams_AV1 structure provides the picture-level parameters of a compressed picture for AV1 video decoding.
Syntax
typedef struct _DXVA_PicParams_AV1 {
UINT width;
UINT height;
UINT max_width;
UINT max_height;
UCHAR CurrPicTextureIndex;
UCHAR superres_denom;
UCHAR bitdepth;
UCHAR seq_profile;
struct {
UCHAR cols;
UCHAR rows;
USHORT context_update_id;
USHORT widths[64];
USHORT heights[64];
} tiles;
union {
struct {
UINT use_128x128_superblock : 1;
UINT intra_edge_filter : 1;
UINT interintra_compound : 1;
UINT masked_compound : 1;
UINT warped_motion : 1;
UINT dual_filter : 1;
UINT jnt_comp : 1;
UINT screen_content_tools : 1;
UINT integer_mv : 1;
UINT cdef : 1;
UINT restoration : 1;
UINT film_grain : 1;
UINT intrabc : 1;
UINT high_precision_mv : 1;
UINT switchable_motion_mode : 1;
UINT filter_intra : 1;
UINT disable_frame_end_update_cdf : 1;
UINT disable_cdf_update : 1;
UINT reference_mode : 1;
UINT skip_mode : 1;
UINT reduced_tx_set : 1;
UINT superres : 1;
UINT tx_mode : 2;
UINT use_ref_frame_mvs : 1;
UINT enable_ref_frame_mvs : 1;
UINT reference_frame_update : 1;
UINT Reserved : 5;
};
UINT32 CodingParamToolFlags;
} coding;
union {
struct {
UCHAR frame_type : 2;
UCHAR show_frame : 1;
UCHAR showable_frame : 1;
UCHAR subsampling_x : 1;
UCHAR subsampling_y : 1;
UCHAR mono_chrome : 1;
UCHAR Reserved : 1;
};
UCHAR FormatAndPictureInfoFlags;
} format;
UCHAR primary_ref_frame;
UCHAR order_hint;
UCHAR order_hint_bits;
DXVA_PicEntry_AV1 frame_refs[7];
UCHAR RefFrameMapTextureIndex[8];
struct {
UCHAR filter_level[2];
UCHAR filter_level_u;
UCHAR filter_level_v;
UCHAR sharpness_level;
union {
struct {
UCHAR mode_ref_delta_enabled : 1;
UCHAR mode_ref_delta_update : 1;
UCHAR delta_lf_multi : 1;
UCHAR delta_lf_present : 1;
UCHAR Reserved : 4;
};
UCHAR ControlFlags;
} DUMMYUNIONNAME;
CHAR ref_deltas[8];
CHAR mode_deltas[2];
UCHAR delta_lf_res;
UCHAR frame_restoration_type[3];
USHORT log2_restoration_unit_size[3];
UINT16 Reserved16Bits;
} loop_filter;
struct {
union {
struct {
UCHAR delta_q_present : 1;
UCHAR delta_q_res : 2;
UCHAR Reserved : 5;
};
UCHAR ControlFlags;
} DUMMYUNIONNAME;
UCHAR base_qindex;
CHAR y_dc_delta_q;
CHAR u_dc_delta_q;
CHAR v_dc_delta_q;
CHAR u_ac_delta_q;
CHAR v_ac_delta_q;
UCHAR qm_y;
UCHAR qm_u;
UCHAR qm_v;
UINT16 Reserved16Bits;
} quantization;
struct {
union {
struct {
UCHAR damping : 2;
UCHAR bits : 2;
UCHAR Reserved : 4;
};
UCHAR ControlFlags;
} DUMMYUNIONNAME;
union {
struct {
UCHAR primary : 6;
UCHAR secondary : 2;
};
UCHAR combined;
};
__unnamed_union_1573_58 y_strengths[8];
union {
struct {
UCHAR primary : 6;
UCHAR secondary : 2;
};
UCHAR combined;
};
__unnamed_union_1573_60 uv_strengths[8];
} cdef;
UCHAR interp_filter;
struct {
union {
struct {
UCHAR enabled : 1;
UCHAR update_map : 1;
UCHAR update_data : 1;
UCHAR temporal_update : 1;
UCHAR Reserved : 4;
};
UCHAR ControlFlags;
} DUMMYUNIONNAME;
UCHAR Reserved24Bits[3];
union {
struct {
UCHAR alt_q : 1;
UCHAR alt_lf_y_v : 1;
UCHAR alt_lf_y_h : 1;
UCHAR alt_lf_u : 1;
UCHAR alt_lf_v : 1;
UCHAR ref_frame : 1;
UCHAR skip : 1;
UCHAR globalmv : 1;
};
UCHAR mask;
};
__unnamed_union_1573_65 feature_mask[8];
SHORT feature_data[8][8];
} segmentation;
struct {
union {
struct {
USHORT apply_grain : 1;
USHORT scaling_shift_minus8 : 2;
USHORT chroma_scaling_from_luma : 1;
USHORT ar_coeff_lag : 2;
USHORT ar_coeff_shift_minus6 : 2;
USHORT grain_scale_shift : 2;
USHORT overlap_flag : 1;
USHORT clip_to_restricted_range : 1;
USHORT matrix_coeff_is_identity : 1;
USHORT Reserved : 3;
};
USHORT ControlFlags;
} DUMMYUNIONNAME;
USHORT grain_seed;
UCHAR scaling_points_y[14][2];
UCHAR num_y_points;
UCHAR scaling_points_cb[10][2];
UCHAR num_cb_points;
UCHAR scaling_points_cr[10][2];
UCHAR num_cr_points;
UCHAR ar_coeffs_y[24];
UCHAR ar_coeffs_cb[25];
UCHAR ar_coeffs_cr[25];
UCHAR cb_mult;
UCHAR cb_luma_mult;
UCHAR cr_mult;
UCHAR cr_luma_mult;
UCHAR Reserved8Bits;
SHORT cb_offset;
SHORT cr_offset;
} film_grain;
UINT Reserved32Bits;
UINT StatusReportFeedbackNumber;
} DXVA_PicParams_AV1, *LPDXVA_PicParams_AV1;
Members
width
Coded width of the current frame. Corresponds to the frame_width_minus_1 syntax element. See Remarks.
height
Coded height of the current frame. Corresponds to the frame_height_minus_1 syntax element. See Remarks.
max_width
max_height
CurrPicTextureIndex
The destination frame buffer/surface index for the decoded picture.
superres_denom
When superres is enabled, this field specifies the denominator for computing the updated frame width. This corresponds to the SuperresDenom value from the AV1 specification. When superres is not enabled, this value shall be 8.
bitdepth
The bit depth of the luma and chroma decoded samples. The allowed values are restricted by the profile value.
seq_profile
The profile of the AV1 bitstream. This corresponds to the syntax element: seq_profile. The AV1 video coding format defines the following profiles:
| Profile | Meaning |
|---|---|
| profile 0 | Supports 4:2:0 chroma sampling with 8 or 10 bits per sample and monochrome formats. |
| profile 1 | Supports 4:4:4 chroma sampling with 8 or 10 bits per sample. |
| profile 2 | Supports 4:2:0, 4:2:2, or 4:4:4 chroma sampling at 8, 10 or 12 bits per sample and monochrome formats. |
tiles
Contains information specific to tiles.
tiles.cols
The number of tiles across a frame. This field corresponds to 2^TileColsLog2 from the AV1 specification.
tiles.rows
The number of tiles down a frame. This field corresponds to 2^TileRowsLog2 from the AV1 specification.
tiles.context_update_id
Specifies which tile to use for CDF update. This corresponds to the syntax element named context_update_tile_id from the AV1 specification.
tiles.widths[64]
The widths of each tile, in units of superblocks. Only the first 2^cols_log2 widths entries are valid. This field corresponds to the tileWidthSb variable from the AV1 specification.
tiles.heights[64]
The heights of each tile, in units of superblocks. Only the first 2^rows_log2 heights entries are valid. This field corresponds to the tileHeightSb variable from the AV1 specification.
coding
The coding tools.
coding.use_128x128_superblock
When equal to 1, indicates that superblocks contain 128x128 luma samples; otherwise, superblocks contain 64x64 luma samples. This field corresponds to the syntax element of the same name from the AV1 specification.
coding.intra_edge_filter
Specifies whether the intra edge filtering process should be enabled. This field corresponds to the syntax element named enable_intra_edge_filter from the AV1 specification.
coding.interintra_compound
When equal to 1, indicates that the mode info for inter blocks may contain the syntax element interintra; otherwise, the interintra syntax element will not be present. This field corresponds to the syntax element named enable_interintra_compound from the AV1 specification.
coding.masked_compound
When equal to 1, indicates that the mode info for inter blocks may contain the syntax element compound_type; otherwise, the compound_type syntax element will not be present. This field corresponds to the syntax element named enable_masked_compound from the AV1 specification.
coding.warped_motion
When equal to 1, indicates that the syntax element motion_mode may be present. This field corresponds to the syntax element named allow_warped_motion from the AV1 specification.
coding.dual_filter
When equal to 1, indicates that the inter prediction filter type may be specified independently in the horizontal and vertical directions; otherwise, only one filter type may be specified. This field corresponds to the syntax element named enable_dual_filter from the AV1 specification.
coding.jnt_comp
When equal to 1, indicates that the distance weights process may be used for inter prediction. This field corresponds to the syntax element named enable_jnt_comp from the AV1 specification.
coding.screen_content_tools
When equal to 1, indicates that intra blocks may use palette encoding; otherwise, palette encoding will not be used. This field corresponds to the syntax element named allow_screen_content_tools from the AV1 specification.
coding.integer_mv
When equal to 1, indicates that motion vectors will always be integers. This field corresponds to the syntax element named force_integer_mv from the AV1 specification.
coding.cdef
When equal to 1, indicates that Constrained Directional Enhancement Filter (CDEF) filtering may be enabled. This field corresponds to the syntax element named enable_cdef from the AV1 specification.
coding.restoration
When equal to 1, indicates that loop restoration filtering may be enabled. This field corresponds to the syntax element named enable_restoration from the AV1 specification.
coding.film_grain
When equal to 1, indicates that film grain processing may be enabled. This field corresponds to the syntax element named film_grain_params_present from the AV1 specification.
coding.intrabc
When equal to 1, indicates that intra block copy may be used. This field corresponds to the syntax element named allow_intrabc from the AV1 specification.
coding.high_precision_mv
When equal to 1, indicates that motion vectors are specified to eighth pel precision; otherwise, motion vectors are specified to quarter pel precision. This field corresponds to the syntax element named allow_high_precision_mv from the AV1 specification.
coding.switchable_motion_mode
When equal to 1, indicates that only the SIMPLE motion mode may be used. This field corresponds to the syntax element named is_motion_mode_switchable from the AV1 specification.
coding.filter_intra
When equal to 1, indicates that the use_filter_intra syntax element may be present. This field corresponds to the syntax element named enable_filter_intra from the AV1 specification.
coding.disable_frame_end_update_cdf
Specifies whether the CDF arrays are saved in the symbol decoder exit process. This field corresponds to the syntax element of the same name from the AV1 specification.
coding.disable_cdf_update
Specifies whether the CDF update in the symbol decoding process should be disabled. This field corresponds to the syntax element of the same name from the AV1 specification.
coding.reference_mode
Controls the mode used for reference frame prediction. Can be one of the following values which correspond with the reference mode from the AV1 decoding process:
| reference_mode | Name of reference_mode |
|---|---|
| 0 | SINGLE_REFERENCE |
| 1 | REFERENCE_MODE_SELECT |
coding.skip_mode
Indicates whether skip mode syntax can be specified in compound prediction. This field corresponds to the skip_mode_present syntax element from the AV1 specification.
coding.reduced_tx_set
Specifies whether the frame uses a restricted set of transform types. This field corresponds to the syntax element of the same name from the AV1 specification.
coding.superres
Specifies whether the frame uses super resolution. This field corresponds to the syntax element named use_superres from the AV1 specification.
coding.tx_mode
Specifies how the transform size is determined. This field corresponds to the variable of the same name from the AV1 specification. It can take on one of the following values, as specified in the AV1 specification:
| TxMode value | Name of TxMode |
|---|---|
| 0 | ONLY_4X4 |
| 1 | TX_MODE_LARGEST |
| 2 | TX_MODE_SELECT |
coding.use_ref_frame_mvs
Specifies whether motion vectors from the previous frame should be used for the current frame. This field corresponds to the syntax element of the same name from the AV1 specification.
coding.enable_ref_frame_mvs
Specifies whether use_ref_frame_mvs is disabled for the entire video sequence; when 0 use_ref_frame_mvs will also always be 0. This field corresponds to the syntax element of the same name from the AV1 specification (from the sequence header).
coding.reference_frame_update
Indicates that the reference frame update process as specified by section 7.20 of the AV1 specification should be performed after decoding this frame. Otherwise section 7.21 should be performed.
coding.Reserved
Reserved bit fields to complete the packed structure. Shall be set to 0. The accelerator shall ignore the values in the reserved bit fields.
coding.CodingParamToolFlags
Provides an alternative way to access the bit fields related to coding tool flags.
format
Contains format and picture information.
format.frame_type
The frame type of the current frame. This field corresponds to the syntax element of the same name in the AV1 specification and affects the decoding process accordingly. The allowed values are 0, 1, 2 or 3, for the four types of AV1 frames: KEY_FRAME, INTER_FRAME, INTRA_ONLY_FRAME, and S_FRAME.
format.show_frame
Indicates whether the current frame is intended to be output and displayed after its decoding is completed. This field corresponds to the syntax element of the same name in the AV1 specification and affects the decoding process accordingly. In DXVA, this has no direct effect, as the host controls the display of decoded frames separately by other function calls.
format.showable_frame
When equal to 1, specifies that the frame can be output using the show_existing_frame mechanism; otherwise equal to zero, which specifies that this frame will not be output using the show_existing_frame mechanism.
format.subsampling_x
Together with subsampling_y, indicates the chroma sampling format. See Remarks.
format.subsampling_y
Together with subsampling_x, indicates the chroma sampling format. See Remarks.
format.mono_chrome
Indicates whether the bitstream is monochrome. If 1 then only a luma plane is present. This field corresponds to the syntax element of the same name from the Color Config Syntax of the AV1 specification. The allowed values are restricted by the profile value.
format.Reserved
Reserved bit fields to complete the packed structure. Shall be set to 0. The accelerator shall ignore the values in the reserved bit fields.
format.FormatAndPictureInfoFlags
Provides an alternative way to access the bit fields related to format and picture info.
primary_ref_frame
Specifies which reference frame contains the CDF values and other state that should be loaded at the start of the frame. This field is 0x7 when there is no primary reference frame. It corresponds to the syntax element of the same name from the AV1 specification.
order_hint
The output ordering of the current frame. Corresponds to OrderHint from the AV1 specification.
order_hint_bits
Corresponds to the syntax element named order_hint_bits_minus_1 in the AV1 specification. This field is defined as: order_hint_bits_minus_1 + 1. This field will be 0 when enable_order_hint from the AV1 specification is 0.
When this value is 0, no tools based on OrderHint should be used and the value of order_hint is undefined. When non-zero, it affects the calculation of relative distance accordingly (see function get_relative_dist from the AV1 specification).
frame_refs[7]
RefFrameMapTextureIndex[8]
Array of uncompressed frame buffer surfaces. Entries that will not be used for decoding the current picture, or any subsequent pictures, are indicated by setting this value to 0xFF. If the value is not 0xFF, the entry may be used as a reference surface for decoding the current picture or a subsequent picture in decoding order.
All uncompressed surfaces that correspond to frames that may be used for reference in the decoding process of the current picture or any subsequent picture shall be present in the RefFrameMapTextureIndex array (regardless of whether these pictures are actually used in the decoding process of the current frame). No particular order is specified for the ordering of the entries in the RefFrameMapTextureIndex array.
Note
The accelerator must use the content of the RefFrameMapTextureIndex as provided by the accelerator rather than trying to derive this information from the bitstream (in order to ensure stateless operation for which the decoded frame buffer handling is to be performed under the control of the host rather than inferred from the bitstream by the accelerator).
loop_filter
Structure with loop filter parameters.
loop_filter.filter_level[2]
An array containing loop filter strength values. Corresponds to the syntax element of the same name in the AV1 specification, and affects the decoding processes of the deblocking filter accordingly. See sharpness_level field for more information.
loop_filter.filter_level_u
loop_filter.filter_level_v
loop_filter.sharpness_level
Indicates the sharpness level. The filter_level and sharpness_level values together determine when a block edge is filtered, and by how much the filtering can change the sample values. The loop filter process is described in section 7.14 of the AV1 specification.
loop_filter.DUMMYUNIONNAME
loop_filter.DUMMYUNIONNAME.mode_ref_delta_enabled
When equal to 1, indicates that the filter level depends on the mode and reference frame used to predict a block. This field corresponds to the syntax element named loop_filter_delta_enabled from the AV1 specification.
loop_filter.DUMMYUNIONNAME.mode_ref_delta_update
When equal to 1, indicates that additional syntax elements are present that specify which mode and reference frame deltas are to be updated. This field corresponds to the syntax element named loop_filter_delta_update from the AV1 specification.
loop_filter.DUMMYUNIONNAME.delta_lf_multi
When equal to 1, indicates that separate loop filter deltas are sent for horizontal luma edges, vertical luma edges, U edges and V edges. This field corresponds to the syntax element named delta_lf_multi from the AV1 specification.
loop_filter.DUMMYUNIONNAME.delta_lf_present
When equal to 1, indicates that loop filter deltas are present. This is needed for the loop filter decoding process: read_delta_lf(). This field corresponds to the syntax element named delta_lf_present from the AV1 specification.
loop_filter.DUMMYUNIONNAME.Reserved
Reserved bit fields to complete the packed structure. Shall be set to 0. The accelerator shall ignore the values in the reserved bit fields.
loop_filter.DUMMYUNIONNAME.ControlFlags
Provides an alternative way to access the bit fields related to loop filter flags.
loop_filter.ref_deltas[8]
Corresponds to the syntax element named loop_filter_ref_deltas in the AV1 specification and affects the decoding processes of the loop filter accordingly.
loop_filter.mode_deltas[2]
Corresponds to the syntax element named loop_filter_mode_deltas in the AV1 specification and affects the decoding process of the loop filter accordingly.
loop_filter.delta_lf_res
The left shift which should be applied to the decoded loop filter delta values. This field corresponds to the syntax element of the same name from the AV1 specification.
loop_filter.frame_restoration_type[3]
The loop restoration mode for this frame. This field corresponds to the FrameRestorationType syntax element from the AV1 specification. It can be one of the following, which are the same values as specified in the AV1 specification:
| FrameRestorationType | Name of FrameRestorationType |
|---|---|
| 0 | RESTORE_NONE |
| 1 | RESTORE_WIENER |
| 2 | RESTORE_SGRPROJ |
| 3 | RESTORE_SWITCHABLE |
loop_filter.log2_restoration_unit_size[3]
The log2 size of loop restoration units in units of samples in the current plane. Element 0 corresponds to the luma plane, element 1 to the U plane and element 2 to the V plane. This field corresponds to the log2(LoopRestorationSize[plane]) variable from the AV1 specification.
loop_filter.Reserved16Bits
Reserved bit fields to complete the packed structure. Shall be set to 0. The accelerator shall ignore the values in the reserved bit fields.
quantization
Contains quantization information.
quantization.DUMMYUNIONNAME
quantization.DUMMYUNIONNAME.delta_q_present
Specifies whether the quantizer index delta values are present. This field corresponds to the syntax element of the same name from the AV1 specification.
quantization.DUMMYUNIONNAME.delta_q_res
The left shift, which should be applied to decoded quantizer index delta values. This field corresponds to the syntax element of the same name from the AV1 specification.
quantization.DUMMYUNIONNAME.Reserved
Reserved bit fields to complete the packed structure. Shall be set to 0. The accelerator shall ignore the values in the reserved bit fields.
quantization.DUMMYUNIONNAME.ControlFlags
Provides an alternative way to access the bit fields related to quantization.
quantization.base_qindex
Indicates the base frame qindex. This field corresponds to the syntax element named base_q_idx from the AV1 specification.
quantization.y_dc_delta_q
The Y DC quantizer relative to base_qindex. This field corresponds to DeltaQYDc from the AV1 specification.
quantization.u_dc_delta_q
The U DC quantizer relative to base_qindex. This field corresponds to DeltaQUDc from the AV1 specification.
quantization.v_dc_delta_q
The V DC quantizer relative to base_qindex. This field corresponds to DeltaQVDc from the AV1 specification.
quantization.u_ac_delta_q
The U AC quantizer relative to base_qindex. This field corresponds to DeltaQUAc from the AV1 specification.
quantization.v_ac_delta_q
The V AC quantizer relative to base_qindex. This field corresponds to DeltaQVAc from the AV1 specification.
quantization.qm_y
The level in the quantizer matrix that should be used for luma plane decoding. When unspecified (using_qmatrix=0), this field will be 0xFF (which is an invalid quantizer matrix level). This field corresponds to the syntax element of the same name from the AV1 specification.
quantization.qm_u
The level in the quantizer matrix that should be used for U-plane decoding. When unspecified (using_qmatrix=0), this field will be 0xFF (which is an invalid quantizer matrix level). This field corresponds to the syntax element of the same name from the AV1 specification.
quantization.qm_v
The level in the quantizer matrix that should be used for V-plane decoding. When unspecified (using_qmatrix=0), this field will be 0xFF (which is an invalid quantizer matrix level). This field corresponds to the syntax element of the same name from the AV1 specification.
quantization.Reserved16Bits
Reserved.
cdef
Constrained directional enhancement filter (CDEF) parameters.
cdef.DUMMYUNIONNAME
cdef.DUMMYUNIONNAME.damping
Controls the amount of damping in the deringing filter. This field corresponds to the variable named cdef_damping_minus_3 from the AV1 specification.
cdef.DUMMYUNIONNAME.bits
The number of bits used to signal the CDEF filter setting. This field corresponds to the syntax element named cdef_bits from the AV1 specification.
cdef.DUMMYUNIONNAME.Reserved
Reserved bit fields to complete the packed structure. Shall be set to 0. The accelerator shall ignore the values in the reserved bit fields.
cdef.DUMMYUNIONNAME.ControlFlags
Provides an alternative way to access the bit fields related to CDEF parameters.
cdef.primary
Primary filter strength for the y-channel. This field corresponds to cdef_y_pri_strength from the AV1 specification.
cdef.secondary
Secondary filter strength for the y-channel. This field corresponds to cdef_y_sec_strength from the AV1 specification.
cdef.combined
Provides an alternative way to access the y_strengths primary and secondary bits.
cdef.y_strengths[8]
The primary and secondary filter strengths for the y-channel.
cdef.uv_strengths[8]
The primary and secondary filter strengths for the uv-channels. This corresponds to the cdef_uv_pri_strength, and cdef_uv_sec_strength syntax elements from the AV1 specification.
interp_filter
Corresponds to the same syntax element of the same name in the AV1 specification and affects the decoding process of motion compensation interpolation accordingly. The table below shows the possible values of interp_filter.
| Value | Filter type |
|---|---|
| 0 | normal 8-tap |
| 1 | smooth 8-tap |
| 2 | sharp 8-tap |
| 3 | bilinear |
| 4 | all filters |
segmentation
Segmentation parameters.
segmentation.DUMMYUNIONNAME
segmentation.DUMMYUNIONNAME.enabled
When equal to 1, indicates that this frame makes use of the segmentation tool. This field corresponds to the syntax element named segmentation_enabled from the AV1 specification.
segmentation.DUMMYUNIONNAME.update_map
When equal to 1, indicates that the segmentation map is updated during the decoding of this frame. This field corresponds to the syntax element named segmentation_update_map from the AV1 specification.
segmentation.DUMMYUNIONNAME.update_data
When equal to 1, indicates that new parameters are supplied for each segment. This field corresponds to the syntax element named segmentation_update_data from the AV1 specification.
segmentation.DUMMYUNIONNAME.temporal_update
When equal to 1, indicates that the updates to the segmentation map are coded relative to the existing segmentation map. This field corresponds to the syntax element named segmentation_temporal_update from the AV1 specification.
segmentation.DUMMYUNIONNAME.Reserved
Reserved bit fields to complete the packed structure. Shall be set to 0. The accelerator shall ignore the values in the reserved bit fields.
segmentation.DUMMYUNIONNAME.ControlFlags
Provides an alternative way to access the bit fields related to segmentation.
segmentation.Reserved24Bits[3]
Reserved.
segmentation.alt_q
segmentation.alt_lf_y_v
segmentation.alt_lf_y_h
segmentation.alt_lf_u
segmentation.alt_lf_v
segmentation.ref_frame
segmentation.skip
segmentation.globalmv
segmentation.mask
segmentation.feature_mask[8]
Specifies which segment data features are updated in this frame. This field corresponds to the syntax element feature_enabled from the AV1 specification.
segmentation.feature_data[8]
Specifies segmentation feature values. This field corresponds to the syntax element feature_value from the AV1 specification.
film_grain
Film grain parameters.
film_grain.DUMMYUNIONNAME
film_grain.DUMMYUNIONNAME.apply_grain
When equal to 1, indicates that film grain should be added to this frame. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.DUMMYUNIONNAME.scaling_shift_minus8
The shift -8 applied to values of the chroma component. This field corresponds to the syntax element named grain_scaling_minus8 from the AV1 specification.
film_grain.DUMMYUNIONNAME.chroma_scaling_from_luma
When equal to 1, specifies that the chroma scaling is inferred from the luma scaling. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.DUMMYUNIONNAME.ar_coeff_lag
The number of auto-regressive coefficients for luma and chroma. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.DUMMYUNIONNAME.ar_coeff_shift_minus6
The range of auto-regressive coefficients. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.DUMMYUNIONNAME.grain_scale_shift
Specifies how much the Gaussian random numbers should be scaled down during the grain synthesis process. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.DUMMYUNIONNAME.overlap_flag
When equal to 1, indicates that the overlap between film grain blocks shall be applied. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.DUMMYUNIONNAME.clip_to_restricted_range
If equal to 1, indicates that clipping to the restricted (studio) range shall be applied to the sample values after adding the film grain (see the semantics for color_range for an explanation of studio swing). If equal to 0, indicates that clipping to the full range shall be applied to the sample values after adding the film grain.
film_grain.DUMMYUNIONNAME.matrix_coeff_is_identity
film_grain.DUMMYUNIONNAME.Reserved
Reserved bit fields to complete the packed structure. Shall be set to 0. The accelerator shall ignore the values in the reserved bit fields.
film_grain.DUMMYUNIONNAME.ControlFlags
Provides an alternative way to access the bit fields related to film grain.
film_grain.grain_seed
The starting value for the pseudo-random number generator used for film grain synthesis. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.scaling_points_y[14]
Represents the x,y coordinates for the piecewise linear scaling function for the y-plane. This is a 2D array, at each piecewise segment the first value specified is the x (luma value) coordinate and the second value is the scaling value (y, output). This field corresponds to the point_y_value syntax element from the AV1 specification.
film_grain.num_y_points
The number of valid piecewise segments specified in scaling_points_y. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.scaling_points_cb[10]
Represents the x,y coordinates for the piecewise linear scaling function for the cb-plane. This is a 2D array, at each piecewise segment the first value specified is the x (luma value) coordinate and the second value is the scaling value (y, output). This field corresponds to the point_cb_value syntax element from the AV1 specification.
film_grain.num_cb_points
The number of valid piecewise segments specified in scaling_points_cb. This field corresponds to the syntax elements of the same name from the AV1 specification.
film_grain.scaling_points_cr[10]
Represents the x,y coordinates for the piecewise linear scaling function for the cr-plane. This is a 2D array, at each piecewise segment the first value specified is the x (luma value) coordinate and the second value is the scaling value (y, output). This field corresponds to the point_cr_value syntax element from the AV1 specification.
film_grain.num_cr_points
The number of valid piecewise segments specified in scaling_points_cr. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.ar_coeffs_y[24]
The auto-regressive coefficients for the Y plane. This field corresponds to the ar_coeffs_y_plus_128 syntax element from the AV1 specification.
film_grain.ar_coeffs_cb[25]
The auto-regressive coefficients for the U plane. This field corresponds to the ar_coeffs_cb_plus_128 syntax element from the AV1 specification.
film_grain.ar_coeffs_cr[25]
The auto-regressive coefficients for the V plane. This field corresponds to the ar_coeffs_cr_plus_128 syntax element from the AV1 specification.
film_grain.cb_mult
The multiplier for the Cb component used in derivation of the input index to the component scaling function. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.cb_luma_mult
The multiplier used for the luma component into the Cb component scaling function. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.cr_mult
The multiplier for the Cr component used in derivation of the input index to the component scaling function. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.cr_luma_mult
The multiplier used for the luma component into the Cr component scaling function. This field corresponds to the syntax elements of the same name from the AV1 specification.
film_grain.Reserved8Bits
Reserved.
film_grain.cb_offset
The offset used in derivation of the input index to the Cb component scaling function. This field corresponds to the syntax element of the same name from the AV1 specification.
film_grain.cr_offset
The offset used in derivation of the input index to the Cr component scaling function. This field corresponds to the syntax element of the same name from the AV1 specification.
Reserved32Bits
Reserved.
StatusReportFeedbackNumber
Arbitrary number set by the host decoder to use as a tag in the status report feedback data. The value should not be equal to 0, and should be different in each call to Execute. For more information, see the Status Report Data Structure section in the Direct X Video Acceleration Specification for AV1 Video Coding.
Remarks
If width and height are derived for the frame (for example via the frame_size_override_flag), the host decoder will derive the appropriate values and store the result in these fields. If superres is enabled, these values represent the post-scaled frame resolution (referred to in the AV1 specification as UpscaledWidth).
The allowed values of subsampling_x and subsampling_y are constrained by the profile value. The following table specifies the allowed values for subsampling_x and subsampling_y, and the associated chroma formats.
| subsampling_x | subsampling_y | Chroma format |
|---|---|---|
| 1 | 1 | 4:2:0 |
| 1 | 0 | 4:2:2 |
| 0 | 0 | 4:4:4 |
See the Direct X Video Acceleration Specification for AV1 Video Coding for detailed information, including how to use this structure.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported server | Windows Server 2022 |
| Header | dxva.h |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for