DXGKARG_FORMATHISTORYBUFFER struttura (d3dkmddi.h)

Contiene informazioni per il driver miniport visualizzato 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;

Members

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 del sistema non a pagina usata dal driver per archiviare le informazioni sul timestamp derivate dal buffer di cronologia non formattato fornito.

Il buffer a cui fa riferimento pFormattedBuffer deve essere gestito come matrice di timestamp di precisione specificata da Precisione. Il buffer non deve contenere informazioni sull'intestazione già presenti nel buffer della cronologia originale.

FormattedBufferSize

Dimensioni, in byte, del buffer a cui fa riferimento pFormattedBuffer. Il driver deve assicurarsi che non scrivi i 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 fa riferimento 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 fa riferimento pFormattedBuffer.

Precision

Struttura DXGKARG_HISTORYBUFFERPRECISION che il driver riempie con informazioni sulla precisione dei timestamp che verranno registrati nella struttura Traccia eventi per Windows (ETW).

Valore della DXGKARG_HISTORYBUFFERPRECISION. Il membro PrecisionBits non può essere zero.

Offset

In input a 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 alla funzione, il driver deve impostare il valore su zero se è stato formattato correttamente tutti i timestamp nel buffer della cronologia.

Se non zero, il driver non è riuscito a formattare tutti i timestamp nel buffer della cronologia senza riempire il buffer formattato. In questo caso, il valore rappresenta l'offset che deve essere continuato dalla chiamata alla funzione successiva.

Commenti

Il driver deve ottenere voci timestamp e il numero di timestamp utilizzabili dall'intestazione del buffer di cronologia fornito. Tutti i dati aggiuntivi necessari per i calcoli devono essere archiviati nei dati privati.

Requisiti

Vedi anche

DXGKARG_HISTORYBUFFERPRECISION

DXGK_HISTORY_BUFFER

DxgkDdiFormatHistoryBuffer