Edit

D3DKMT_FLIPMODEL_PRESENTHISTORYTOKENFLAGS structure (d3dkmthk.h)

  • Article

The D3DKMT_FLIPMODEL_PRESENTHISTORYTOKENFLAGS structure identifies attributes of a flip present-history operation.

Syntax

typedef struct _D3DKMT_FLIPMODEL_PRESENTHISTORYTOKENFLAGS {
  union {
    struct {
      UINT                                    Video : 1;
      UINT                                    RestrictedContent : 1;
      UINT                                    ClipToView : 1;
      UINT                                    StereoPreferRight : 1;
      UINT                                    TemporaryMono : 1;
      UINT                                    FlipRestart : 1;
      UINT                                    HDRMetaDataChanged : 1;
      UINT                                    AlphaMode : 2;
      UINT                                    SignalLimitOnTokenCompletion : 1;
      UINT                                    YCbCrFlags : 3;
      UINT                                    IndependentFlip : 1;
      D3DKMT_FLIPMODEL_INDEPENDENT_FLIP_STAGE IndependentFlipStage : 2;
      UINT                                    IndependentFlipReleaseCount : 2;
      UINT                                    IndependentFlipForceNotifyDwm : 1;
      UINT                                    UseCustomDuration : 1;
      UINT                                    IndependentFlipRequestDwmConfirm : 1;
      UINT                                    IndependentFlipCandidate : 1;
      UINT                                    IndependentFlipCheckNeeded : 1;
      UINT                                    IndependentFlipTrueImmediate : 1;
      UINT                                    IndependentFlipRequestDwmExit : 1;
      UINT                                    CompSurfaceNotifiedEarly : 1;
      UINT                                    IndependentFlipDoNotFlip : 1;
      UINT                                    RequirePairedToken : 1;
      UINT                                    VariableRefreshOverrideEligible : 1;
#if ...
      UINT                                    Reserved : 3;
#else
      UINT                                    Reserved : 29;
#endif
    };
    UINT Value;
  };
} D3DKMT_FLIPMODEL_PRESENTHISTORYTOKENFLAGS;

Members

Video

A UINT value that specifies whether the flip operation is performed with video.

RestrictedContent

A UINT value that specifies whether the flip operation is performed with restricted content.

ClipToView

A UINT value that specifies whether the flip operation is clipped to the view surface.

StereoPreferRight

A UINT value that specifies that when the driver clones a stereo primary allocation to a mono monitor, it should use the right image.

Supported starting with Windows 8.

TemporaryMono

A UINT value that specifies whether the driver should use the left image of a stereo allocation for the right and left portions of a stereo frame.

This member should be set only if the driver reports support for this option in the current display mode by setting the Type member of the D3DKMDT_VIDPN_SOURCE_MODE structure to D3DKMDT_RMT_GRAPHICS_STEREO_ADVANCED_SCAN.

Supported starting with Windows 8.

FlipRestart

A UINT value that specifies whether to restart a flip to a new surface.

Supported starting with Windows 8.

HDRMetaDataChanged

AlphaMode

A UINT value that specifies whether the DWM should use alpha transparency information when it composes swap buffers.

Setting this member is equivalent to setting the eighth and ninth bits of the 32-bit Value member (0x00000180).

Supported starting with Windows 8.

SignalLimitOnTokenCompletion

A UINT value that specifies the limit for the number of present operations that can be queued for the device after the GPU has finished processing the token.

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

Supported starting with Windows 8.

YCbCrFlags

IndependentFlip

IndependentFlipStage

IndependentFlipReleaseCount

IndependentFlipForceNotifyDwm

UseCustomDuration

IndependentFlipRequestDwmConfirm

IndependentFlipCandidate

IndependentFlipCheckNeeded

IndependentFlipTrueImmediate

IndependentFlipRequestDwmExit

CompSurfaceNotifiedEarly

IndependentFlipDoNotFlip

RequirePairedToken

Require a paired token.

VariableRefreshOverrideEligible

Reserved

Supported starting with Windows 8.

This member is reserved and should be set to zero.

Value

An alternative way to access the bit-field flags.

Requirements

Requirement Value
Minimum supported client Windows 7
Header d3dkmthk.h (include D3dkmthk.h)

See also

D3DKMT_PRESENTHISTORYTOKEN