D3DKMT_PRESENTHISTORYTOKEN 구조체(d3dkmthk.h)

아티클
08/07/2023

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_PM_REDIRECTED_FLIP 경우 D3DKMT_PRESENTHISTORYTOKEN 포함된 토큰 공용 구조체는 이 구조를 보유합니다.

[in/out] Token.Blt

비트 블록 전송(비트블렛) 현재 기록 작업을 식별하는 D3DKMT_BLTMODEL_PRESENTHISTORYTOKEN 구조체입니다. D3DKMT_PRESENTHISTORYTOKEN 포함된 공용 구조체는 Model 멤버가 D3DKMT_PM_REDIRECTED_BLT 경우 이 형식의 구조를 보유합니다.

[in/out] Token.VistaBlt

Windows Vista 비트 블록 전송(비트blt) 현재 기록 작업을 식별하는 ULONGLONG 값입니다. 모델 멤버가 D3DKMT_PM_REDIRECTED_VISTABLT 경우 D3DKMT_PRESENTHISTORYTOKEN 포함된 공용 구조체는 이 형식의 값을 보유합니다.

[in/out] Token.Gdi

GDI 현재 기록 작업을 식별하는 D3DKMT_GDIMODEL_PRESENTHISTORYTOKEN 구조체입니다. 모델 멤버가 D3DKMT_PM_REDIRECTED_GDI 경우 D3DKMT_PRESENTHISTORYTOKEN 포함된 공용 구조체는 이 형식의 구조를 보유합니다.

[in/out] Token.Fence

펜스 현재 기록 작업을 식별하는 D3DKMT_FENCE_PRESENTHISTORYTOKEN 구조체입니다. 모델 멤버가 D3DKMT_PM_SCREENCAPTUREFENCE 경우 D3DKMT_PRESENTHISTORYTOKEN 포함된 공용 구조체는 이 형식의 구조를 보유합니다.

[in/out] Token.GdiSysMem

GDI 시스템 현재 기록 작업을 식별하는 D3DKMT_GDIMODEL_SYSMEM_PRESENTHISTORYTOKEN 구조체입니다. D3DKMT_PRESENTHISTORYTOKEN 포함된 공용 구조체는 Model 멤버가 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 포함)