DXGK_HISTORY_BUFFER_HEADER struttura (d3dkmddi.h)

Specifica il modo in cui i dati vengono archiviati 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 della D3DDDICB_RENDERFLAGS. Membro valore da utilizzare in una chiamata alla funzione pfnRenderCb .

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

NumTimestamps

Numero di timestamp che saranno presenti nel buffer della 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 struttura 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 della 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 della cronologia non deve essere formattato quando il buffer DMA completa l'esecuzione, quando il sottosistema kernel della grafica 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, le parti dell'intestazione verranno registrate separatamente.

Requisiti

   
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