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
Flip

[in/out] A D3DKMT_FLIPMODEL_PRESENTHISTORYTOKEN structure that identifies a flip present-history operation. The Token union that is contained in D3DKMT_PRESENTHISTORYTOKEN holds this structure if the Model member is D3DKMT_PM_REDIRECTED_FLIP.

Blt

[in/out] A D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN structure that identifies a bit-block transfer (bitblt) present-history operation. The union that is contained in D3DKMT_PRESENTHISTORYTOKEN holds a structure of this type if the Model member is D3DKMT_PM_REDIRECTED_BLT.

VistaBlt

[in/out] A ULONGLONG value that identifies a Windows Vista bit-block transfer (bitblt) present-history operation. The union that is contained in D3DKMT_PRESENTHISTORYTOKEN holds a value of this type if the Model member is D3DKMT_PM_REDIRECTED_VISTABLT.

Gdi

[in/out] A D3DKMT_GDIMODEL_PRESENTHISTORYTOKEN structure that identifies a GDI present-history operation. The union that is contained in D3DKMT_PRESENTHISTORYTOKEN holds a structure of this type if the Model member is D3DKMT_PM_REDIRECTED_GDI.

Fence

[in/out] A D3DKMT_FENCE_PRESENTHISTORYTOKEN structure that identifies a fence present-history operation. The union that is contained in D3DKMT_PRESENTHISTORYTOKEN holds a structure of this type if the Model member is D3DKMT_PM_SCREENCAPTUREFENCE.

GdiSysMem

[in/out] A D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN structure that identifies a GDI system present-history operation. The union that is contained in D3DKMT_PRESENTHISTORYTOKEN holds a structure of this type if the Model member is D3DKMT_PM_REDIRECTED_GDI_SYSMEM.

Composition

[in/out] A D3DKMT_COMPOSITION_PRESENTHISTORYTOKEN structure that identifies a composition swap chain present-history operation. This type of presentation is used for XAML-based apps.

Supported starting with Windows 8.1.

Requirements

Version

D3DKMT_PRESENTHISTORYTOKEN is supported beginning with the Windows 7 operating system.

Header

D3dkmthk.h (include D3dkmthk.h)

See also

D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN
D3DKMT_FENCE_PRESENTHISTORYTOKEN
D3DKMT_FLIPMODEL_PRESENTHISTORYTOKEN
D3DKMT_GDIMODEL_PRESENTHISTORYTOKEN
D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN
D3DKMT_PRESENT_MODEL

 

 

Send comments about this topic to Microsoft

Show: