DXVA2_VideoProcessBltParams structure (dxva2api.h)

Contains parameters for the IDirectXVideoProcessor::VideoProcessBlt method.

Syntax

typedef struct _DXVA2_VideoProcessBltParams {
  REFERENCE_TIME       TargetFrame;
  RECT                 TargetRect;
  SIZE                 ConstrictionSize;
  UINT                 StreamingFlags;
  DXVA2_AYUVSample16   BackgroundColor;
  DXVA2_ExtendedFormat DestFormat;
  DXVA2_ProcAmpValues  ProcAmpValues;
  DXVA2_Fixed32        Alpha;
  DXVA2_FilterValues   NoiseFilterLuma;
  DXVA2_FilterValues   NoiseFilterChroma;
  DXVA2_FilterValues   DetailFilterLuma;
  DXVA2_FilterValues   DetailFilterChroma;
  DWORD                DestData;
} DXVA2_VideoProcessBltParams;

Members

TargetFrame

Presentation time for the target frame, in 100-nanosecond units. If the video is interlaced, this value must be either the start time for the frame or the midpoint for the frame. If the video is progressive, this value must be the start time.

TargetRect

Specifies the target rectangle, which is the rectangle within the destination surface where the output video frame is drawn.

The target rectangle cannot be larger than the destination surface.

ConstrictionSize

Size to which the output video should be downsampled. If this feature is supported, the driver sets the DXVA2_VideoProcess_Constriction flag in the DXVA2_VideoProcessorCaps structure.

The downsampling size cannot be less than zero, or larger than the size of the target rectangle (TargetRect).

StreamingFlags

Reserved. Set to zero.

BackgroundColor

A DXVA2_AYUVSample16 structure that specifies the background color for the destination rectangle. The background color is used wherever no video image appears, but only within the TargetRect rectangle. The color is specified as an AYUV color value with 16 bits per channel.

The alpha channel (Alpha) must be opaque (0xFFFF). The DXVA driver should ignore the value of the alpha channel.

The color space for the background color is given by the DestFormat member. Note that the background color is always specified as a YUV color, even if the destination surface is RGB.

DestFormat

A DXVA2_ExtendedFormat structure that contains extended color information for the destination rectangle. For video playback, the recommended value for the nominal range is DXVA2_NominalRange_Unknown. For more information, see DXVA2_NominalRange enumeration.

ProcAmpValues

A DXVA2_ProcAmpValues structure that specifies color adjustment (ProcAmp) settings. These values must fall within the ranges returned by the IDirectXVideoProcessor::GetProcAmpRange method.

Alpha

Alpha value that is applied to the composited image when it is copied to the destination surface. The alpha value is fixed-point value, specified as a DXVA2_Fixed32 structure. To specify 100% opacity, use the DXVA2_Fixed32OpaqueAlpha function.

NoiseFilterLuma

A DXVA2_FilterValues structure that contains parameters for the luma noise filter.

NoiseFilterChroma

A DXVA2_FilterValues structure that contains parameters for the chroma noise filter.

DetailFilterLuma

A DXVA2_FilterValues structure that contains parameters for the luma detail filter.

DetailFilterChroma

A DXVA2_FilterValues structure that contains parameters for the chroma detail filter.

DestData

Contains additional flags. The following flags are defined.

Value Meaning
DXVA2_DestData_RFF
Repeat first field (RFF) bit.
DXVA2_DestData_TFF
Top field first (TFF) bit.
DXVA2_DestData_RFF_TFF_Present
If set, the RFF and TFF flags are used.
 

Currently, these flags are ignored. They are intended for use with interlaced output, which is not supported at this time.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header dxva2api.h

See also

DXVA Video Processing

Media Foundation Structures