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 |