D3DKMT_PRESENTHISTORYTOKEN structure

The D3DKMT_PRESENTHISTORYTOKEN structure identifies a type of present operation.

Syntax

typedef struct _D3DKMT_PRESENTHISTORYTOKEN {
  D3DKMT_PRESENT_MODEL Model;
  UINT                 TokenSize;
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
  UINT64               CompositionBindingId;
#endif
  union {
    D3DKMT_FLIPMODEL_PRESENTHISTORYTOKEN       Flip;
    D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN        Blt;
    D3DKMT_VISTABLTMODEL_PRESENTHISTORYTOKEN   VistaBlt;
    D3DKMT_GDIMODEL_PRESENTHISTORYTOKEN        Gdi;
    D3DKMT_FENCE_PRESENTHISTORYTOKEN           Fence;
    D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN GdiSysMem;
    D3DKMT_COMPOSITION_PRESENTHISTORYTOKEN     Composition;
  } Token;
} D3DKMT_PRESENTHISTORYTOKEN;

Members

Model

[in] A D3DKMT_PRESENT_MODEL-typed value that indicates the model for a present operation.

TokenSize

[in] The size, in bytes, of the present history token including the value in the Model member. When you submit a token, you should set TokenSize to zero. When the ICD calls D3DKMTGetPresentHistory to retrieve present history, the runtime initializes TokenSize. You can then use the value in TokenSize to go to the next token in the present-history buffer.

A present history token is a data packet that the rendering app submits to inform the Desktop Window Manager (DWM) that rendering is complete and the swap chain back buffer is ready to be presented.

CompositionBindingId

The identifer of the active bound buffer of the composition surface.

Supported starting with Windows 8.

Token

A present history token.

Token.Flip

Token.Blt

Token.VistaBlt

Token.Gdi

Token.Fence

Token.GdiSysMem

Token.Composition

Token.FlipManager

Token.SurfaceComplete

Requirements

   
Minimum supported client D3DKMT_PRESENTHISTORYTOKEN is supported beginning with the Windows 7 operating system.
Header d3dkmthk.h (include D3dkmthk.h)

See Also

D3DKMT_GDIMODEL_PRESENTHISTORYTOKEN

D3DKMT_PRESENT_MODEL

D3DKMT_FLIPMODEL_PRESENTHISTORYTOKEN

D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN

D3DKMT_FENCE_PRESENTHISTORYTOKEN

D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN