struttura DXGKARG_FORMATHISTORYBUFFER (d3dkmddi.h)
Contiene informazioni per il driver miniport di visualizzazione per formattare un buffer di cronologia.
Sintassi
typedef struct _DXGKARG_FORMATHISTORYBUFFER {
DXGK_HISTORY_BUFFER *pHistoryBuffer;
UINT32 HistoryBufferSize;
PVOID pFormattedBuffer;
UINT32 FormattedBufferSize;
UINT32 NumTimestamps;
DXGKARG_HISTORYBUFFERPRECISION Precision;
UINT32 Offset;
} DXGKARG_FORMATHISTORYBUFFER;
Membri
pHistoryBuffer
Puntatore al buffer di cronologia DXGK_HISTORY_BUFFER non formattato popolato dalla GPU.
HistoryBufferSize
Dimensioni, in byte, del buffer a cui punta pHistoryBuffer.
pFormattedBuffer
Puntatore a un segmento di memoria di sistema non di paging utilizzato dal driver per archiviare le informazioni relative al timestamp che deriva dal buffer di cronologia non formattato fornito.
Il buffer a cui punta pFormattedBuffer deve essere gestito come una grande matrice di timestamp di precisione specificata da Precision. Il buffer non deve contenere informazioni di intestazione già presenti nel buffer di cronologia originale.
FormattedBufferSize
Dimensione, in byte, del buffer a cui punta pFormattedBuffer. Il driver deve assicurarsi che non scriva dati oltre questa dimensione del buffer.
NumTimestamps
Numero di timestamp. Al termine di una chiamata alla funzione DxgkDdiFormatHistoryBuffer, il driver deve impostare questo valore sul numero di timestamp scritti nel buffer formattato a cui punta pFormattedBuffer.
Si noti che il numero di timestamp che saranno presenti nel buffer di output formattato non sarà noto finché il driver non completa il buffer formattato a cui punta pFormattedBuffer.
Precision
Struttura DXGKARG_HISTORYBUFFERPRECISION che il driver inserisce informazioni sulla precisione dei timestamp che verranno registrati nella struttura Event Tracing for Windows (ETW).
Valore del DXGKARG_HISTORYBUFFERPRECISION.membro PrecisionBits non può essere zero.
Offset
All'input di una chiamata alla funzione DxgkDdiFormatHistoryBuffer, il valore di questo membro è l'offset al primo timestamp in corrispondenza del quale deve iniziare la formattazione. Al termine della chiamata di funzione, il driver deve impostare il valore su zero se è stato formattato correttamente tutti i timestamp nel buffer della cronologia.
Se diverso da zero, il driver non è riuscito a formattare tutti i timestamp nel buffer di cronologia senza riempire il buffer formattato. In questo caso, il valore rappresenta l'offset che deve essere continuato da nella chiamata di funzione successiva.
Osservazioni
Il driver deve ottenere le voci del timestamp e il numero di timestamp utilizzabili dall'intestazione del buffer di cronologia fornito. Eventuali dati aggiuntivi necessari al driver per i calcoli devono essere archiviati in dati privati.
Fabbisogno
| 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) |