D3DKMT_PRESENTHISTORYTOKEN Struktur (d3dkmthk.h)

Artikel
02/06/2025

Die D3DKMT_PRESENTHISTORYTOKEN Struktur identifiziert einen Typ des aktuellen Vorgangs.

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

Angehörige

[in] Model

Ein D3DKMT_PRESENT_MODEL Enumerationswert, der das Modell für einen vorhandenen Vorgang angibt.

[in] TokenSize

Die Größe des aktuellen Verlaufstokens in Bytes, einschließlich des Werts im Model Member. Wenn Sie ein Token übermitteln, sollten Sie TokenSize auf Null festlegen. Wenn die ICD D3DKMTGetPresentHistory aufruft, um den aktuellen Verlauf abzurufen, initialisiert die Laufzeit TokenSize. Anschließend können Sie den Wert in TokenSize- verwenden, um zum nächsten Token im Present-History-Puffer zu wechseln.

Ein aktuelles Verlaufstoken ist ein Datenpaket, das von der Render-App übermittelt wird, um den Desktop Window Manager (DWM) darüber zu informieren, dass das Rendern abgeschlossen ist und der Swapchain-Hintergrundpuffer zur Darstellung bereit ist.

CompositionBindingId

Der Bezeichner des aktiven gebundenen Puffers der Kompositionsoberfläche.

Wird ab Windows 8 unterstützt.

Token

Ein aktuelles Verlaufstoken.

Token.MaxSize[1064]

[in/out] Token.Flip

Eine D3DKMT_FLIPMODEL_PRESENTHISTORYTOKEN Struktur, die einen Flip Present-History-Vorgang identifiziert. Die Token Union, die in D3DKMT_PRESENTHISTORYTOKEN enthalten ist, enthält diese Struktur, wenn das Model Mitglied D3DKMT_PM_REDIRECTED_FLIP ist.

[in/out] Token.Blt

Eine D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN Struktur, die einen Bitblockübertragungsvorgang (Bitblt) identifiziert. Die in D3DKMT_PRESENTHISTORYTOKEN enthaltene Vereinigung enthält eine Struktur dieses Typs, wenn das Model Mitglied D3DKMT_PM_REDIRECTED_BLT ist.

[in/out] Token.VistaBlt

Ein ULONGLONG-Wert, der einen Bitblockübertragungsvorgang (Bitblt) für Windows Vista identifiziert. Die union, die in D3DKMT_PRESENTHISTORYTOKEN enthalten ist, enthält einen Wert dieses Typs, wenn das Model Mitglied D3DKMT_PM_REDIRECTED_VISTABLT ist.

[in/out] Token.Gdi

Eine D3DKMT_GDIMODEL_PRESENTHISTORYTOKEN Struktur, die einen GDI-Vorgang für den aktuellen Verlauf identifiziert. Die in D3DKMT_PRESENTHISTORYTOKEN enthaltene Vereinigung enthält eine Struktur dieses Typs, wenn das Model Mitglied D3DKMT_PM_REDIRECTED_GDI ist.

[in/out] Token.Fence

Eine D3DKMT_FENCE_PRESENTHISTORYTOKEN Struktur, die einen Zaun-Gegenwärtig-Geschichte-Vorgang identifiziert. Die in D3DKMT_PRESENTHISTORYTOKEN enthaltene Vereinigung enthält eine Struktur dieses Typs, wenn das Model Mitglied D3DKMT_PM_SCREENCAPTUREFENCE ist.

[in/out] Token.GdiSysMem

Eine D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN Struktur, die einen GDI-System-Present-History-Vorgang identifiziert. Die in D3DKMT_PRESENTHISTORYTOKEN enthaltene Vereinigung enthält eine Struktur dieses Typs, wenn das Model Mitglied D3DKMT_PM_REDIRECTED_GDI_SYSMEM ist.

[in/out] Token.Composition

Eine D3DKMT_COMPOSITION_PRESENTHISTORYTOKEN Struktur, die einen Zusammenstellungs-Swapchain-Vorgang zum Präsentieren des Verlaufs identifiziert. Dieser Präsentationstyp wird für XAML-basierte Apps verwendet.

Wird ab Windows 8.1 unterstützt.

Token.FlipManager

Eine D3DKMT_FLIPMANAGER_PRESENTHISTORYTOKEN Struktur, die einen Flip-Manager-Vorgang identifiziert.

Token.SurfaceComplete

Eine D3DKMT_SURFACECOMPLETE_PRESENTHISTORYTOKEN Struktur, die einen oberflächenvervollständigen Vorgang identifiziert.

Unterstützt ab Windows 10, Version 1607.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	D3DKMT_PRESENTHISTORYTOKEN wird ab dem Windows 7-Betriebssystem unterstützt.
Header-	d3dkmthk.h (einschließlich D3dkmthk.h)