structure D3DKMT_PRESENT_STATS (d3dkmthk.h)
La structure D3DKMT_PRESENT_STATS décrit les status présentes pour un appareil de rendu.
Syntaxe
typedef struct _D3DKMT_PRESENT_STATS {
[out] UINT PresentCount;
[out] UINT PresentRefreshCount;
[out] UINT SyncRefreshCount;
[out] D3DKMT_ALIGN64 LARGE_INTEGER SyncQPCTime;
[out] D3DKMT_ALIGN64 LARGE_INTEGER SyncGPUTime;
} D3DKMT_PRESENT_STATS;
Membres
[out] PresentCount
Valeur UINT qui indique le nombre de fois où le pilote client installable (ICD) OpenGL a appelé la fonction D3DKMTPresent sur un périphérique de rendu ou une chaîne d’échange. Une fois la valeur maximale atteinte, PresentCount redémarre à zéro. Lorsqu’un appareil de rendu est créé, PresentCount est initialisé à zéro. Le système d’exploitation gère un compteur présent pour chaque chaîne d’échange créée.
[out] PresentRefreshCount
Valeur UINT qui indique le nombre de fois où le contrôleur d’affichage génère une nouvelle image vidéo, qui se produit au début de chaque période de retracement vertical. Le système d’exploitation gère un compteur d’actualisation actuel pour chaque sortie du contrôleur d’affichage vidéo dans le système d’exploitation. PresentRefreshCount est initialisé à une valeur non spécifiée.
[out] SyncRefreshCount
Valeur UINT qui indique le nombre de captures les plus récentes des informations de minutage dans les membres SyncQPCTime et SyncGPUTime .
[out] SyncQPCTime
Heure de l’unité de traitement de l’ordinateur (UC) à laquelle la trame vidéo actuelle a été sortie (autrement dit, l’heure du processeur à laquelle le retracement vertical a démarré).
[out] SyncGPUTime
Heure de l’unité de traitement graphique (GPU) à laquelle l’image vidéo actuelle a été sortie (c’est-à-dire l’heure GPU à laquelle le retracement vertical a démarré).
Remarques
Lorsqu’une opération présente est supprimée, le système d’exploitation conserve une correspondance (mappage) entre la valeur dans PresentCount et la valeur dans PresentRefreshCount ; autrement dit, lorsque le système d’exploitation termine une opération présente en tant que trame vidéo analysée, la valeur dans PresentRefreshCount avec laquelle l’opération actuelle a été terminée est associée à la valeur dans PresentCount de l’opération actuelle mise hors service.
Le système d’exploitation conserve les informations de minutage au sein d’un appareil de rendu et associe les informations de minutage à une sortie d’affichage. Lorsque le GPU peut gérer l’heure du GPU (SyncGPUTime), l’heure GPU fonctionne à une fréquence spécifique à l’appareil. Pour permettre aux applications de lier l’heure du GPU à d’autres opérations dans le système, le système d’exploitation maintient une correspondance entre l’heure du GPU et l’heure du processeur (SyncQPCTime). Lorsque le GPU ne peut pas gérer ce temps GPU, le système d’exploitation conserve uniquement le temps processeur et le temps GPU associé est toujours égal à zéro.
Les statistiques présentes ne peuvent pas fonctionner pour les appareils en mode fenêtré. Pour le mode fenêtré, chaque membre de structure est défini sur zéro.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| En-tête | d3dkmthk.h (inclure D3dkmthk.h) |