Edit

DXGI_DDI_PRESENT_FLAGS structure (dxgiddi.h)

  • Article

Identifies how to perform a present operation.

Syntax

typedef struct DXGI_DDI_PRESENT_FLAGS {
  union {
    struct {
      UINT Blt : 1;
      UINT Flip : 1;
      UINT PreferRight : 1;
      UINT TemporaryMono : 1;
      UINT AllowTearing : 1;
      UINT AllowFlexibleRefresh : 1;
      UINT NoScanoutTransform : 1;
      UINT Reserved : 25;
    };
    UINT Value;
  };
} DXGI_DDI_PRESENT_FLAGS;

Members

Blt

Specifies whether to perform a bit-block transfer (bitblt) data to the primary surface.

Setting this member is equivalent to setting the first bit of the 32-bit Value member (0x00000001).

Flip

Specifies whether to flip to a new surface.

Setting this member is equivalent to setting the second bit of the 32-bit Value member (0x00000002).

PreferRight

Supported in Windows 8 and later versions.

Specifies that, if a stereo present operation must be reduced to mono, the present operation should show the view from the right eye.

If this member is not set, the default mono present operation shows the view from the left eye.

Setting this member is equivalent to setting the third bit of the 32-bit Value member (0x00000004).

TemporaryMono

Supported in Windows 8 and later versions.

Specifies that a present operation should use the left buffer as a mono (non-stereo) buffer.

Setting this member is equivalent to setting the fourth bit of the 32-bit Value member (0x00000008).

AllowTearing

AllowFlexibleRefresh

NoScanoutTransform

Supported in Windows 10, version 1901 and later.

This flag will only be passed if the driver set the D3DWDDM2_6DDI_SCANOUT_FLAG_TRANSFORMATION_DESIRED flag, instead of the D3DWDDM2_6DDI_SCANOUT_FLAG_TRANSFORMATION_REQUIRED flag of the D3DWDDM2_6DDI_SCANOUT_FLAGS enumeration.

Reserved

This member is reserved and should be set to zero. Setting this member to zero is equivalent to setting the remaining 28 bits (0xFFFFFFF0) of the 32-bit Value member to zeros.

Value

A member in the union that is contained in DXGI_DDI_PRESENT_FLAGS that can hold one 32-bit value that identifies how to perform a present operation.

Requirements

Requirement Value
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Header dxgiddi.h (include D3d10umddi.h)

See also

DXGI_DDI_ARG_PRESENT

PresentDXGI