структура D3DKMT_PRESENTHISTORYTOKEN (d3dkmthk.h)

Статья
02/23/2024

Структура D3DKMT_PRESENTHISTORYTOKEN определяет тип текущей операции.

Синтаксис

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;

Члены

[in] Model

Значение перечисления D3DKMT_PRESENT_MODEL , указывающее модель для текущей операции.

[in] TokenSize

Размер (в байтах) текущего маркера журнала, включая значение в элементе Model . При отправке маркера необходимо задать для TokenSize значение 0. Когда ICD вызывает D3DKMTGetPresentHistory для получения текущего журнала, среда выполнения инициализирует TokenSize. Затем можно использовать значение в TokenSize , чтобы перейти к следующему маркеру в буфере текущего журнала.

Настоящий токен журнала — это пакет данных, который приложение отрисовки отправляет, чтобы сообщить диспетчеру окон рабочего стола (DWM) о завершении отрисовки и готовности обратного буфера цепочки буферов к представлению.

CompositionBindingId

Идентификатор активного привязанного буфера поверхности композиции.

Поддерживается начиная с Windows 8.

Token

Настоящий маркер журнала.

Token.MaxSize[1064]

[in/out] Token.Flip

Структура D3DKMT_FLIPMODEL_PRESENTHISTORYTOKEN , идентифицирующая операцию переворачивания текущего журнала. Объединение маркеров , содержащееся в D3DKMT_PRESENTHISTORYTOKEN, содержит эту структуру, если элемент Модели D3DKMT_PM_REDIRECTED_FLIP.

[in/out] Token.Blt

Структура D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN , которая идентифицирует операцию передачи битовой блокировки (bitblt) в настоящее время. Объединение, содержащееся в D3DKMT_PRESENTHISTORYTOKEN содержит структуру этого типа, если элемент Модели D3DKMT_PM_REDIRECTED_BLT.

[in/out] Token.VistaBlt

Значение ULONGLONG, идентифицирующее операцию передачи битовых блоков Windows Vista (bitblt) в настоящее время. Объединение, содержащееся в D3DKMT_PRESENTHISTORYTOKEN содержит значение этого типа, если элемент Модели D3DKMT_PM_REDIRECTED_VISTABLT.

[in/out] Token.Gdi

Структура D3DKMT_GDIMODEL_PRESENTHISTORYTOKEN, идентифицирующая текущую операцию GDI. Объединение, содержащееся в D3DKMT_PRESENTHISTORYTOKEN содержит структуру этого типа, если элемент Модели D3DKMT_PM_REDIRECTED_GDI.

[in/out] Token.Fence

Структура D3DKMT_FENCE_PRESENTHISTORYTOKEN, которая идентифицирует операцию забора в настоящее время истории. Объединение, содержащееся в D3DKMT_PRESENTHISTORYTOKEN содержит структуру этого типа, если элемент Модели D3DKMT_PM_SCREENCAPTUREFENCE.

[in/out] Token.GdiSysMem

Структура D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN, идентифицирующая текущую операцию системы GDI. Объединение, содержащееся в D3DKMT_PRESENTHISTORYTOKEN, содержит структуру этого типа, если элемент Модели D3DKMT_PM_REDIRECTED_GDI_SYSMEM.

[in/out] Token.Composition

Структура D3DKMT_COMPOSITION_PRESENTHISTORYTOKEN , идентифицирующая текущую операцию цепочки буферов композиции. Этот тип представления используется для приложений на основе XAML.

Поддерживается начиная с Windows 8.1.

Token.FlipManager

Структура D3DKMT_FLIPMANAGER_PRESENTHISTORYTOKEN , идентифицирующая операцию диспетчера переворачивания.

Token.SurfaceComplete

Структура D3DKMT_SURFACECOMPLETE_PRESENTHISTORYTOKEN , идентифицирующая операцию завершения поверхности.

Поддерживается начиная с Windows 10 версии 1607.

Требования

Требование	Значение
Минимальная версия клиента	D3DKMT_PRESENTHISTORYTOKEN поддерживается начиная с операционной системы Windows 7.
Верхняя часть	d3dkmthk.h (включая D3dkmthk.h)