struttura D3DKMT_PRESENTHISTORYTOKEN (d3dkmthk.h)

Articolo
08/07/2023

La struttura D3DKMT_PRESENTHISTORYTOKEN identifica un tipo di operazione presente.

Sintassi

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;

Members

[in] Model

Valore di enumerazione D3DKMT_PRESENT_MODEL che indica il modello per un'operazione corrente.

[in] TokenSize

Dimensione, in byte, del token di cronologia corrente, incluso il valore nel membro Model . Quando si invia un token, è necessario impostare TokenSize su zero. Quando progettazione immagine e configurazione chiama D3DKMTGetPresentHistory per recuperare la cronologia attuale, il runtime inizializza TokenSize. È quindi possibile usare il valore in TokenSize per passare al token successivo nel buffer della cronologia corrente.

Un token di cronologia presente è un pacchetto di dati inviato dall'app di rendering per informare Desktop Window Manager (DWM) che il rendering è completo e che il buffer back della catena di scambio è pronto per essere presentato.

CompositionBindingId

Identificatore del buffer associato attivo della superficie di composizione.

Supportato a partire da Windows 8.

Token

Token di cronologia presente.

Token.MaxSize[1064]

[in/out] Token.Flip

Struttura D3DKMT_FLIPMODEL_PRESENTHISTORYTOKEN che identifica un'operazione di presentazione della cronologia. L'unione token contenuta in D3DKMT_PRESENTHISTORYTOKEN contiene questa struttura se il membro Model è D3DKMT_PM_REDIRECTED_FLIP.

[in/out] Token.Blt

Struttura di D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN che identifica un'operazione di cronologia corrente del trasferimento a blocchi di bit (bitblt). L'unione contenuta in D3DKMT_PRESENTHISTORYTOKEN contiene una struttura di questo tipo se il membro Model è D3DKMT_PM_REDIRECTED_BLT.

[in/out] Token.VistaBlt

Valore di ULONGLONG che identifica un'operazione di cronologia dei blocchi di bit (bitblt) di Windows Vista. L'unione contenuta in D3DKMT_PRESENTHISTORYTOKEN contiene un valore di questo tipo se il membro Model è D3DKMT_PM_REDIRECTED_VISTABLT.

[in/out] Token.Gdi

Struttura D3DKMT_GDIMODEL_PRESENTHISTORYTOKEN che identifica un'operazione di cronologia corrente GDI. L'unione contenuta in D3DKMT_PRESENTHISTORYTOKEN contiene una struttura di questo tipo se il membro Model è D3DKMT_PM_REDIRECTED_GDI.

[in/out] Token.Fence

Struttura D3DKMT_FENCE_PRESENTHISTORYTOKEN che identifica un'operazione di cronologia attuale del recinto. L'unione contenuta in D3DKMT_PRESENTHISTORYTOKEN contiene una struttura di questo tipo se il membro Model è D3DKMT_PM_SCREENCAPTUREFENCE.

[in/out] Token.GdiSysMem

Struttura D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN che identifica un'operazione di cronologia attuale del sistema GDI. L'unione contenuta in D3DKMT_PRESENTHISTORYTOKEN contiene una struttura di questo tipo se il membro Model è D3DKMT_PM_REDIRECTED_GDI_SYSMEM.

[in/out] Token.Composition

Struttura D3DKMT_COMPOSITION_PRESENTHISTORYTOKEN che identifica un'operazione di presente cronologia della catena di scambio di composizione. Questo tipo di presentazione viene usato per le app basate su XAML.

Supportato a partire da Windows 8.1.

Token.FlipManager

Struttura D3DKMT_FLIPMANAGER_PRESENTHISTORYTOKEN che identifica un'operazione di gestione capovolgimento.

Token.SurfaceComplete

Struttura D3DKMT_SURFACECOMPLETE_PRESENTHISTORYTOKEN che identifica un'operazione di completamento della superficie.

Supportato a partire da Windows 10 versione 1607.

Requisiti

Requisito	Valore
Client minimo supportato	D3DKMT_PRESENTHISTORYTOKEN è supportato a partire dal sistema operativo Windows 7.
Intestazione	d3dkmthk.h (include D3dkmthk.h)