estrutura D3DKMT_PRESENTHISTORYTOKEN (d3dkmthk.h)

Artigo
05/24/2024

A estrutura D3DKMT_PRESENTHISTORYTOKEN identifica um tipo de operação atual.

Sintaxe

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;

Membros

[in] Model

Um D3DKMT_PRESENT_MODEL valor de enumeração que indica o modelo para uma operação atual.

[in] TokenSize

O tamanho, em bytes, do token de histórico atual, incluindo o valor no membro Model . Ao enviar um token, você deve definir TokenSize como zero. Quando o ICD chama D3DKMTGetPresentHistory para recuperar o histórico atual, o runtime inicializa TokenSize. Em seguida, você pode usar o valor em TokenSize para ir para o próximo token no buffer de histórico atual.

Um token de histórico atual é um pacote de dados que o aplicativo de renderização envia para informar ao DWM (Gerenciador de Janelas da Área de Trabalho) que a renderização está concluída e que o buffer de fundo da cadeia de troca está pronto para ser apresentado.

CompositionBindingId

O identificador do buffer associado ativo da superfície de composição.

Com suporte a partir do Windows 8.

Token

Um token de histórico presente.

Token.MaxSize[1064]

[in/out] Token.Flip

Uma estrutura D3DKMT_FLIPMODEL_PRESENTHISTORYTOKEN que identifica uma operação de inverter o histórico atual. A união token contida em D3DKMT_PRESENTHISTORYTOKEN mantém essa estrutura se o membro Modelo for D3DKMT_PM_REDIRECTED_FLIP.

[in/out] Token.Blt

Uma estrutura D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN que identifica uma operação de histórico atual de transferência de bloco de bits (bitblt). A união contida em D3DKMT_PRESENTHISTORYTOKEN conterá uma estrutura desse tipo se o membro Model for D3DKMT_PM_REDIRECTED_BLT.

[in/out] Token.VistaBlt

Um valor ULONGLONG que identifica uma operação de histórico atual de transferência de bloco de bits (bitblt) do Windows Vista. A união contida em D3DKMT_PRESENTHISTORYTOKEN conterá um valor desse tipo se o membro Model for D3DKMT_PM_REDIRECTED_VISTABLT.

[in/out] Token.Gdi

Uma estrutura D3DKMT_GDIMODEL_PRESENTHISTORYTOKEN que identifica uma operação de histórico presente da GDI. A união contida em D3DKMT_PRESENTHISTORYTOKEN conterá uma estrutura desse tipo se o membro Model for D3DKMT_PM_REDIRECTED_GDI.

[in/out] Token.Fence

Uma estrutura D3DKMT_FENCE_PRESENTHISTORYTOKEN que identifica uma operação de histórico presente de cerca. A união contida em D3DKMT_PRESENTHISTORYTOKEN conterá uma estrutura desse tipo se o membro Model for D3DKMT_PM_SCREENCAPTUREFENCE.

[in/out] Token.GdiSysMem

Uma estrutura D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN que identifica uma operação de histórico presente do sistema GDI. A união contida em D3DKMT_PRESENTHISTORYTOKEN conterá uma estrutura desse tipo se o membro Model for D3DKMT_PM_REDIRECTED_GDI_SYSMEM.

[in/out] Token.Composition

Uma estrutura D3DKMT_COMPOSITION_PRESENTHISTORYTOKEN que identifica uma operação de histórico atual da cadeia de troca de composição. Esse tipo de apresentação é usado para aplicativos baseados em XAML.

Suporte começando com Windows 8.1.

Token.FlipManager

Uma estrutura D3DKMT_FLIPMANAGER_PRESENTHISTORYTOKEN que identifica uma operação do gerenciador de inversão.

Token.SurfaceComplete

Uma estrutura D3DKMT_SURFACECOMPLETE_PRESENTHISTORYTOKEN que identifica uma operação completa da superfície.

Com suporte a partir do Windows 10, versão 1607.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	D3DKMT_PRESENTHISTORYTOKEN tem suporte a partir do sistema operacional Windows 7.
Cabeçalho	d3dkmthk.h (inclua D3dkmthk.h)