Edit

DXVA_VideoSample2 structure (dxva.h)

  • Article

The DXVA_VideoSample2 structure is sent by the renderer to the driver to specify the format of a video sample.

Syntax

typedef struct _DXVA_VideoSample2 {
  DWORD            Size;
  DWORD            Reserved;
  REFERENCE_TIME   rtStart;
  REFERENCE_TIME   rtEnd;
  DWORD            SampleFormat;
  DWORD            SampleFlags;
  VOID             *lpDDSSrcSurface;
  RECT             rcSrc;
  RECT             rcDst;
  DXVA_AYUVsample2 Palette[16];
} DXVA_VideoSample2, *LPDXVA_VideoSample2;

Members

Size

Only compiles for a 64-bit version of the operating system.

Indicates the size of this structure.

Reserved

Only compiles for a 64-bit version of the operating system.

Reserved.

rtStart

Specifies the start time of the sample.

rtEnd

Specifies the end time of the sample.

SampleFormat

Specifies the format of the sample as defined by values of the DXVA_ExtendedFormat enumeration type.

SampleFlags

Specifies a collection of flags that indicate changes in the current sample frame from the previous sample frame. This member is a bitwise-OR of one or more of the flags in the DXVA_SampleFlags enumeration type.

lpDDSSrcSurface

Pointer to a DD_SURFACE_LOCAL structure that represents the sample.

rcSrc

Specifies a RECT structure that describes the upper-left and lower-right points of a rectangle on the source surface. These points define the area of the source data for the bit-block transfer and its position on the source surface.

rcDst

Specifies a RECT structure that describes the upper-left and lower-right points of a rectangle on the destination surface. These points define the area in which the bit-block transfer should occur and its position on the destination surface.

Palette[16]

Specifies an array of DXVA_AYUVsample2 structures that represent a complete 16-color palette for palletized video substream pixel formats. The driver uses this palette to composite the substream sample. For nonpalletized pixel formats, the palette is zero and can be ignored.

Remarks

For video substream samples, the rtStart and rtEnd members are set to 0.

The SampleFormat member indicates whether the sample is a reference for a deinterlace operation or a video substream sample that must be combined with the deinterlaced video frame. The DXVA_SampleSubStream value (new for Windows Server 2003 with SP1 and later and Windows XP with SP2 and later) of the DXVA_SampleFormat enumeration type specifies the format for a video substream sample.

The SampleFlags member contains a collection of flags that indicate changes in the current sample frame from the previous sample frame. You can use these flags to optimize your driver code. In other words, your code is not required to perform operations on the current sample frame if no changes have occurred from the previous sample frame.

For information about how input samples are arranged in the array in the Source member of the DXVA_DeinterlaceBltEx structure, see Input Buffer Order.

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)

See also

DD_SURFACE_LOCAL

DXVA_AYUVsample2

DXVA_DeinterlaceBltEx

DXVA_DeinterlaceCaps

DXVA_ExtendedFormat

DXVA_SampleFlags

DXVA_SampleFormat

RECT