DXGKDDI_CALIBRATEGPUCLOCK fonction de rappel (d3dkmddi.h)

  • Article

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 de l’objet adaptateur pour le GPU pour lequel les informations d’étalonnage de minutage doivent être obtenues.

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

NodeOrdinal

Index d’un nœud pour lequel les informations d’étalonnage de 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 spécifié par NodeOrdinal , pour lequel les informations d’étalonnage de minutage seront obtenues. Pour les cartes graphiques qui ne font pas partie d’un lien dans une configuration d’adaptateur d’affichage lié (LDA), vous devez toujours définir EngineOrdinal sur 0.

pClockCalibration

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

Valeur retournée

Retourne STATUS_SUCCESS si elle réussit ; sinon, il 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 membres GpuClockCounter et CpuClockCounter de la structure DXGKARG_CALIBRATEGPUCLOCK aussi presque que 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 accumulée entre les horloges GPU et processeur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1,WDDM 1.3
Serveur minimal pris en charge Windows Server 2012 R2
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dkmddi.h
IRQL DISPATCH_LEVEL

Voir aussi

DXGKARG_CALIBRATEGPUCLOCK

DXGK_HISTORY_BUFFER

DxgkDdiAddDevice