DXVA_DeinterlaceBltEx structure (dxva.h)
The DXVA_DeinterlaceBltEx structure describes parameters for deinterlace or frame-rate conversion, for combining the deinterlaced or frame-rate-converted video with any supplied video substreams, and for writing the combined output to a destination surface.
Syntax
typedef struct _DXVA_DeinterlaceBltEx {
DWORD Size;
DXVA_AYUVsample2 BackgroundColor;
RECT rcTarget;
REFERENCE_TIME rtTarget;
DWORD NumSourceSurfaces;
FLOAT Alpha;
DXVA_VideoSample2 Source[MAX_DEINTERLACE_SURFACES];
DWORD DestinationFormat;
DWORD DestinationFlags;
} DXVA_DeinterlaceBltEx;
Members
Size
Specifies the size of the structure, in bytes.
BackgroundColor
Specifies a DXVA_AYUVsample2 structure that identifies background color and opacity level. For Windows Server 2003 with SP1 and Windows XP with SP2, the opacity level is not used and should be ignored by the driver.
rcTarget
Specifies a pointer to a RECT structure that describes the location within the destination surface to which the output image is written. Note that the output image is restricted to the pixels within the rcTarget rectangle--that is, every pixel within this rectangle must be written to; pixels outside this rectangle must not be modified.
rtTarget
Identifies the location of the output frame within the sequence of input frames. If only deinterlacing is performed, the target time should coincide with either the starting display time of a sample, as defined in the DXVA_VideoSample2 structure, or the midpoint between the starting display time and the ending display time. For more information, see Remarks.
If a frame-rate conversion is requested, the rtTarget time can be different from any of the rtStart times of the samples.
NumSourceSurfaces
Specifies the number of valid surfaces passed in the Source array.
Alpha
Specifies the planar-transparency value of the output image as it is written to the destination surface. For Windows Server 2003 with SP1 and Windows XP with SP2, this value is always 1.0F, which indicates that the overall image is opaque and that no alpha blending on the overall image is required.
Source[MAX_DEINTERLACE_SURFACES]
Specifies an array of DXVA_VideoSample2 structures that describe the input samples that are required for the deinterlacing, frame-rate conversion, and substream-compositing operations. For information about how input samples are arranged in this array, see Input Buffer Order.
DestinationFormat
Specifies format information for the destination surface. For Windows Server 2003 with SP1 and Windows XP with SP2, this member is set to 0.
DestinationFlags
Specifies a collection of flags that indicate changes in the current destination surface from the previous destination surface. This member is a bitwise-OR of one or more of the flags in the DXVA_DestinationFlags enumeration type.
Remarks
The render sends the DXVA_DeinterlaceBltEx structure to the accelerator to specify the deinterlace or frame-rate conversion parameters for bit-block transfers.
When a single frame is being created from one field in a sample, as defined in the DXVA_VideoSample2 structure, rtTarget should be the starting display time for that field. If you have two fields in one sample and want to deinterlace both, DeinterlaceBltEx will be called twice. The first time DeinterlaceBltEx is called, rtTarget will be the starting display time. The second time DeinterlaceBltEx is called, rtTarget will be the midpoint between the starting display time and the ending display time. In other words, for the first call, rtTarget = rtStart. For the second call, rtTarget = (rtStart + rtEnd) / 2.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | This structure applies only to Windows Server 2003 with SP1 and later, and Windows XP with SP2 and later. |
| Header | dxva.h (include Dxva.h) |