D3DKMT_PRESENTHISTORYTOKEN structure (d3dkmthk.h)

Article
02/26/2024

La structure D3DKMT_PRESENTHISTORYTOKEN identifie un type d’opération actuelle.

Syntaxe

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;
        D3DKMT_FLIPMANAGER_PRESENTHISTORYTOKEN      FlipManager;
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM2_1)
        D3DKMT_SURFACECOMPLETE_PRESENTHISTORYTOKEN  SurfaceComplete;
#endif
    }
    Token;
} D3DKMT_PRESENTHISTORYTOKEN;

Membres

[in] Model

Valeur d’énumération D3DKMT_PRESENT_MODEL qui indique le modèle d’une opération actuelle.

[in] TokenSize

Taille, en octets, du jeton d’historique actuel, y compris la valeur dans le membre Model . Lorsque vous envoyez un jeton, vous devez définir TokenSize sur zéro. Lorsque l’ICD appelle D3DKMTGetPresentHistory pour récupérer l’historique actuel, le runtime initialise TokenSize. Vous pouvez ensuite utiliser la valeur dans TokenSize pour accéder au jeton suivant dans la mémoire tampon de l’historique actuel.

Un jeton d’historique actuel est un paquet de données que l’application de rendu envoie pour informer le Gestionnaire de fenêtres du bureau (DWM) que le rendu est terminé et que la mémoire tampon de retour de la chaîne d’échange est prête à être présentée.

CompositionBindingId

Identificateur de la mémoire tampon liée active de l’aire de composition.

Pris en charge à partir de Windows 8.

Token

Jeton d’historique actuel.

Token.MaxSize[1064]

[in/out] Token.Flip

Structure D3DKMT_FLIPMODEL_PRESENTHISTORYTOKEN qui identifie une opération d’historique actuel inversé. L’union de jetons contenue dans D3DKMT_PRESENTHISTORYTOKEN contient cette structure si le membre du modèle est D3DKMT_PM_REDIRECTED_FLIP.

[in/out] Token.Blt

Structure D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN qui identifie une opération d’historique actuel de transfert de bloc de bits (bitblt). L’union contenue dans D3DKMT_PRESENTHISTORYTOKEN contient une structure de ce type si le membre model est D3DKMT_PM_REDIRECTED_BLT.

[in/out] Token.VistaBlt

Valeur ULONGLONG qui identifie une opération de transfert de bloc de bits Windows Vista (bitblt) d’historique actuel. L’union contenue dans D3DKMT_PRESENTHISTORYTOKEN contient une valeur de ce type si le membre model est D3DKMT_PM_REDIRECTED_VISTABLT.

[in/out] Token.Gdi

Structure D3DKMT_GDIMODEL_PRESENTHISTORYTOKEN qui identifie une opération d’historique actuel GDI. L’union contenue dans D3DKMT_PRESENTHISTORYTOKEN contient une structure de ce type si le membre model est D3DKMT_PM_REDIRECTED_GDI.

[in/out] Token.Fence

Structure D3DKMT_FENCE_PRESENTHISTORYTOKEN qui identifie une opération d’historique actuel de clôture. L’union contenue dans D3DKMT_PRESENTHISTORYTOKEN contient une structure de ce type si le membre model est D3DKMT_PM_SCREENCAPTUREFENCE.

[in/out] Token.GdiSysMem

Structure D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN qui identifie une opération d’historique actuel du système GDI. L’union contenue dans D3DKMT_PRESENTHISTORYTOKEN contient une structure de ce type si le membre model est D3DKMT_PM_REDIRECTED_GDI_SYSMEM.

[in/out] Token.Composition

Structure D3DKMT_COMPOSITION_PRESENTHISTORYTOKEN qui identifie une opération d’historique actuel de la chaîne d’échange de composition. Ce type de présentation est utilisé pour les applications XAML.

Pris en charge à partir de Windows 8.1.

Token.FlipManager

Structure D3DKMT_FLIPMANAGER_PRESENTHISTORYTOKEN qui identifie une opération flip manager.

Token.SurfaceComplete

Structure D3DKMT_SURFACECOMPLETE_PRESENTHISTORYTOKEN qui identifie une opération complète de surface.

Pris en charge à partir de Windows 10, version 1607.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	D3DKMT_PRESENTHISTORYTOKEN est pris en charge à partir du système d’exploitation Windows 7.
En-tête	d3dkmthk.h (include D3dkmthk.h)