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 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 |