structure DXGKARG_HISTORYBUFFERPRECISION (d3dkmddi.h)
Indique des informations sur la précision des données de mémoire tampon d’historique utilisées par le pilote 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 de courrier indésirable.
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 de 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 des horodatages 32 bits à l’aide des 32 bits de précision complets. |
| 33–64 | Le pilote doit consigner les horodatages 64 bits. Cette valeur définit le nombre de bits utilisés pour stocker les données par horodatage. Pour réduire le coût de la mise en forme des données, le pilote peut inclure des valeurs de courrier indésirable dans les horodatages 64 bits. Par exemple, le pilote peut écrire des horodatages 64 bits avec 55 bits valides de précision. 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 à présenter les données, il doit fournir la valeur de précision lorsque la fonction DxgkDdiFormatHistoryBuffer est ensuite appelée.
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
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8.1,WDDM 1.3 et versions ultérieures |
| serveur minimum pris en charge | Windows Server 2012 R2 |
| d’en-tête | d3dkmddi.h (include D3dkmddi.h) |