struttura DXGK_HISTORY_BUFFER_HEADER (d3dkmddi.h)

Articolo
08/07/2023

Specifica la modalità di archiviazione dei dati in un buffer di cronologia DXGK_HISTORY_BUFFER .

Sintassi

typedef struct _DXGK_HISTORY_BUFFER_HEADER {
  UINT32 RenderCbSequence;
  UINT32 NumTimestamps;
  UINT32 PrivateDataSize;
  UINT32 Reserved;
} DXGK_HISTORY_BUFFER_HEADER;

Members

RenderCbSequence

Valore del D3DDDICB_RENDERFLAGS. Membro valore da utilizzare in una chiamata alla funzione pfnRenderCb .

Il driver miniport di visualizzazione deve calcolare questo valore e immetterlo in DXGK_HISTORY_BUFFER_HEADER prima di chiamare pfnRenderCb.

NumTimestamps

Numero di timestamp che saranno presenti nel buffer di cronologia quando il buffer DMA completa l'esecuzione.

Il driver deve includere tutti i timestamp registrati, anche se il buffer deve essere formattato prima di essere registrato nella funzionalità Event Tracing for Windows (ETW).

PrivateDataSize

Dimensioni, in byte, di dati privati facoltativi archiviati dal driver. Il driver può usare questi dati per qualsiasi scopo.

Se zero, il driver non deve archiviare i dati privati nel buffer di cronologia.

Nota Questo valore deve essere un multiplo di 8 byte per garantire che i dati del timestamp siano allineati a un limite a 64 bit.

Se il buffer di cronologia non deve essere formattato quando il buffer DMA completa l'esecuzione, quando il sottosistema del kernel grafico DirectX scrive i log in ETW, usa PrivateDataSize come offset diretto dall'intestazione per fare riferimento ai timestamp.

Reserved

Riservato per l'uso del sistema e deve essere impostato su zero.

Commenti

Solo la parte del timestamp del buffer di cronologia, insieme al numero di timestamp, verrà registrata in ETW. I dati di intestazione e i dati del driver privato non verranno registrati in ETW come parte del buffer del timestamp. Tuttavia, parti dell'intestazione verranno registrate separatamente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1,WDDM 1.3 e versioni successive
Server minimo supportato	Windows Server 2012 R2
Intestazione	d3dkmddi.h (include D3dkmddi.h)

Vedi anche

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb

Condividi tramite