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

Статья
02/06/2025

Структура 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

Размер в байтах текущего маркера журнала, включая значение элемента модели. При отправке маркера необходимо задать значение TokenSize равным нулю. Когда 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) bitblt. Объединение, содержащееся в D3DKMT_PRESENTHISTORYTOKEN, содержит структуру этого типа, если элемент модели D3DKMT_PM_REDIRECTED_BLT.

[in/out] Token.VistaBlt

Значение ULONGLONG, определяющее операцию передачи (bitblt) bit-block (bitblt) Windows Vista. Объединение, содержащееся в 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 (include D3dkmthk.h)