structure DXGI_FRAME_STATISTICS (dxgi.h)

Décrit les statistiques de minutage et de présentation d’une image.

Syntaxe

typedef struct DXGI_FRAME_STATISTICS {
  UINT          PresentCount;
  UINT          PresentRefreshCount;
  UINT          SyncRefreshCount;
  LARGE_INTEGER SyncQPCTime;
  LARGE_INTEGER SyncGPUTime;
} DXGI_FRAME_STATISTICS;

Membres

PresentCount

Type : UINT

Valeur qui représente le nombre total de fois qu’une image a été présentée au moniteur depuis le démarrage de l’ordinateur.

Note Le nombre de fois où une image a été présentée au moniteur n’est pas nécessairement identique au nombre de fois où vous avez appelé IDXGISwapChain ::P resent ou IDXGISwapChain1 ::P resent1.

 

PresentRefreshCount

Type : UINT

Valeur qui représente le nombre total en cours d’exécution de v-blanks auxquels la dernière image a été présentée au moniteur et qui s’est produit depuis le démarrage de l’ordinateur (pour le mode fenêtré, depuis la création de la chaîne d’échange).

SyncRefreshCount

Type : UINT

Valeur qui représente le nombre total en cours d’exécution de v-blanks lorsque le planificateur a échantillonné l’heure de l’ordinateur pour la dernière fois en appelant QueryPerformanceCounter et qui se sont produits depuis le démarrage de l’ordinateur (pour le mode fenêtré, depuis la création de la chaîne d’échange).

SyncQPCTime

Type : LARGE_INTEGER

Valeur qui représente le minuteur de compteur de performances haute résolution. Cette valeur est identique à la valeur retournée par la fonction QueryPerformanceCounter .

SyncGPUTime

Type : LARGE_INTEGER

Réservé. Retourne toujours 0.

Remarques

Vous initialisez la structure DXGI_FRAME_STATISTICS avec la méthode IDXGIOutput ::GetFrameStatistics ou IDXGISwapChain ::GetFrameStatistics .

Vous pouvez uniquement utiliser IDXGISwapChain ::GetFrameStatistics pour les chaînes d’échange qui utilisent le modèle de présentation inversée ou dessinent en mode plein écran. Vous définissez la valeur DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL dans le membre SwapEffect de la structure DXGI_SWAP_CHAIN_DESC1 pour spécifier que la chaîne d’échange utilise le modèle de présentation inversé.

Les valeurs des membres PresentCount et PresentRefreshCount indiquent des informations sur le moment où un cadre a été présenté sur l’écran d’affichage. Vous pouvez utiliser ces valeurs pour déterminer si un problème s’est produit. Les valeurs des membres SyncRefreshCount et SyncQPCTime indiquent des informations de minutage que vous pouvez utiliser pour la synchronisation audio et vidéo ou l’animation très précise. Si la chaîne d’échange se dessine en mode plein écran, ces valeurs sont basées sur le démarrage de l’ordinateur. Si la chaîne d’échange dessine en mode fenêtré, ces valeurs sont basées sur le moment où la chaîne d’échange est créée.

Configuration requise

Condition requise	Valeur
En-tête	dxgi.h

Voir aussi

DXGI Structures