structure DXGKARG_HISTORYBUFFERPRECISION (d3dkmddi.h)

  • Article

Indique des informations sur la précision des données de mémoire tampon d’historique utilisées par le pilote de miniport d’affichage.

Syntaxe

typedef struct _DXGKARG_HISTORYBUFFERPRECISION {
  UINT32 PrecisionBits;
} DXGKARG_HISTORYBUFFERPRECISION;

Membres

PrecisionBits

Nombre de bits valides utilisés dans chaque horodatage. Ce nombre n’inclut pas les bits utilisés pour les valeurs indésirables.

Cette valeur de précision a trois plages valides :

Valeur Signification
0 Aucun bits ne contient de données utiles, et le sous-système du noyau graphique DirectX appelle la fonction DxgkDdiFormatHistoryBuffer pour fournir des données valides à la sortie vers la fonctionnalité Suivi d’événements pour Windows (ETW). Lorsque le pilote traite cet appel, il définit une nouvelle valeur de précision comme paramètre de sortie de la fonction.
32 Le pilote doit consigner les horodatages 32 bits à l’aide de la précision complète de 32 bits.
33–64 Le pilote doit consigner les horodatages 64 bits. Cette valeur définit le nombre de bits utilisés pour stocker des données par horodatage.
Pour réduire le coût de mise en forme des données, le pilote peut inclure des valeurs indésirables dans les horodatages 64 bits. Par exemple, le pilote peut écrire des horodatages 64 bits avec 55 bits de précision valides. Dans ce cas, les 9 bits supérieurs sont considérés comme des valeurs indésirables et sont supprimés par ETW.

Les valeurs comprises entre 0 et 32 ne sont pas prises en charge et non valides.

Si le matériel prend en charge les horodatages 64 bits mais que seuls 32 bits sont utilisables, le pilote doit s’assurer que les données sont présentées correctement au sous-système du noyau graphique DirectX. Si le pilote n’a aucune autre alternative pour présenter les données, il doit fournir la valeur de précision lorsque la fonction DxgkDdiFormatHistoryBuffer est appelée ensuite.

Remarques

Dans un appel à la fonction DxgkDdiQueryAdapterInfo , la taille des données de sortie DXGKARG_QUERYADAPTERINFO. OutputDataSize, est :

sizeof(DXGKARG_HISTORYBUFFERPRECISION) * m_DriverCaps.GpuEngineTopology.NbAsymetricProcessingNodes

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1,WDDM 1.3 et versions ultérieures
Serveur minimal pris en charge Windows Server 2012 R2
En-tête d3dkmddi.h (inclure D3dkmddi.h)

Voir aussi

DXGKARG_QUERYADAPTERINFO

DxgkDdiFormatHistoryBuffer

DxgkDdiQueryAdapterInfo