Partager via


DXGKDDI_CALIBRATEGPUCLOCK fonction de rappel (d3dkmddi.h)

Appelé par le sous-système du noyau graphique Microsoft DirectX pour étalonner les horodatages GPU dans la mémoire tampon d’historique DXGK_HISTORY_BUFFER avec l’heure de l’horloge du processeur.

Syntaxe

DXGKDDI_CALIBRATEGPUCLOCK DxgkddiCalibrategpuclock;

NTSTATUS DxgkddiCalibrategpuclock(
  IN_CONST_HANDLE hAdapter,
  IN UINT32 NodeOrdinal,
  IN UINT32 EngineOrdinal,
  OUT_PDXGKARG_CALIBRATEGPUCLOCK pClockCalibration
)
{...}

Paramètres

hAdapter

Handle vers l’objet adaptateur pour le GPU pour lequel les informations d’étalonnage du minutage doivent être obtenues.

Le pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique DirectX dans le MiniportDeviceContext paramètre de sortie de la fonction DxgkDdiAddDevice.

NodeOrdinal

Index d’un nœud pour lequel les informations d’étalonnage du minutage seront obtenues. Ce nœud se trouve dans l’adaptateur physique défini par le paramètre hAdapter.

EngineOrdinal

Index de base zéro du moteur, dans le nœud qui NodeOrdinal spécifie, pour lequel les informations d’étalonnage du minutage seront obtenues. Pour les cartes graphiques qui ne font pas partie d’un lien dans une configuration de carte d’affichage liée (LDA), vous devez toujours définir EngineOrdinal sur 0.

pClockCalibration

Pointeur vers une structure DXGKARG_CALIBRATEGPUCLOCK qui fournit des informations de compteur d’horloge à partir du GPU et du processeur.

Valeur de retour

Retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Le sous-système du noyau graphique DirectX utilise les informations retournées dans le paramètre pClockCalibration pour estimer la dérive entre les horloges GPU et processeur.

Pour réduire les inexactitudes d’étalonnage, le pilote doit calculer les valeurs des GpuClockCounter et CpuClockCounter membres de la structure DXGKARG_CALIBRATEGPUCLOCK le plus simultanément possible.

Le sous-système du noyau graphique DirectX appelle cette fonction assez souvent, généralement au moins une fois toutes les 30 ms, pour réduire la dérive cumulée entre le GPU et les horloges du processeur.

Exigences

Exigence Valeur
client minimum pris en charge Windows 8.1,WDDM 1.3
serveur minimum pris en charge Windows Server 2012 R2
plateforme cible Bureau
d’en-tête d3dkmddi.h
IRQL DISPATCH_LEVEL

Voir aussi

DXGKARG_CALIBRATEGPUCLOCK

DXGK_HISTORY_BUFFER

DxgkDdiAddDevice