D3DKMT_PRESENTHISTORYTOKEN Struktur (d3dkmthk.h)

Artikel
02/23/2024

Die D3DKMT_PRESENTHISTORYTOKEN-Struktur identifiziert einen Typ des gegenwärtigen 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;

Member

[in] Model

Ein D3DKMT_PRESENT_MODEL Enumerationswert, der das Modell für einen aktuellen 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 0 festlegen. Wenn der ICD D3DKMTGetPresentHistory aufruft , um den aktuellen Verlauf abzurufen, initialisiert die Runtime TokenSize. Anschließend können Sie den Wert in TokenSize verwenden, um zum nächsten Token im Puffer für den aktuellen Verlauf zu wechseln.

Ein vorhandenes Verlaufstoken ist ein Datenpaket, das die Rendering-App übermittelt, um den Desktopfenster-Manager (DWM) darüber zu informieren, dass das Rendering abgeschlossen ist und der Swap Chain-Back-Puffer bereit für die Präsentation ist.

CompositionBindingId

Der Bezeichner des aktiv 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 Vorgang zum Anzeigen der Gegenwart identifiziert. Die Tokenunion , die in D3DKMT_PRESENTHISTORYTOKEN enthalten ist, enthält diese Struktur, wenn das Modellelement D3DKMT_PM_REDIRECTED_FLIP ist.

[in/out] Token.Blt

Eine D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN-Struktur , die einen Bitblockübertragungsvorgang (Bitblt) für den aktuellen Verlauf identifiziert. Die Union, die in D3DKMT_PRESENTHISTORYTOKEN enthalten ist, enthält eine Struktur dieses Typs, wenn das Modellelement D3DKMT_PM_REDIRECTED_BLT ist.

[in/out] Token.VistaBlt

Ein ULONGLONG-Wert, der einen Windows Vista-Bitblockübertragungsvorgang (Bitblt) für den aktuellen Verlauf identifiziert. Die Union, die in D3DKMT_PRESENTHISTORYTOKEN enthalten ist, enthält einen Wert dieses Typs, wenn das Model-Element 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 Union, die in D3DKMT_PRESENTHISTORYTOKEN enthalten ist, enthält eine Struktur dieses Typs, wenn das Model-Element D3DKMT_PM_REDIRECTED_GDI ist.

[in/out] Token.Fence

Eine D3DKMT_FENCE_PRESENTHISTORYTOKEN-Struktur , die einen Vorgang zum Gegenwärtigen-Verlauf des Zauns identifiziert. Die Union, die in D3DKMT_PRESENTHISTORYTOKEN enthalten ist, enthält eine Struktur dieses Typs, wenn das Model-Element D3DKMT_PM_SCREENCAPTUREFENCE ist.

[in/out] Token.GdiSysMem

Eine D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN-Struktur , die einen GDI-Systemverlaufsvorgang identifiziert. Die Union, die in D3DKMT_PRESENTHISTORYTOKEN enthalten ist, enthält eine Struktur dieses Typs, wenn das Modellelement D3DKMT_PM_REDIRECTED_GDI_SYSMEM ist.

[in/out] Token.Composition

Eine D3DKMT_COMPOSITION_PRESENTHISTORYTOKEN-Struktur , die einen Kompositions-Swapchain-Gegenwartsverlaufsvorgang identifiziert. Diese Art von Präsentation 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
Unterstützte Mindestversion (Client)	D3DKMT_PRESENTHISTORYTOKEN wird ab dem Windows 7-Betriebssystem unterstützt.
Kopfzeile	d3dkmthk.h (einschließlich D3dkmthk.h)