IDXGIDevice1 ::SetMaximumFrameLatency, méthode (dxgi.h)

Définit le nombre d’images que le système est autorisé à mettre en file d’attente pour le rendu.

Syntaxe

HRESULT SetMaximumFrameLatency(
  UINT MaxLatency
);

Paramètres

MaxLatency

Type : UINT

Nombre maximal d’images de mémoire tampon arrière qu’un pilote peut mettre en file d’attente. La valeur par défaut est 3, mais peut être comprise entre 1 et 16. La valeur 0 réinitialise la latence par défaut. Pour les appareils multifacteur, cette valeur est spécifiée par tête.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ; sinon, DXGI_ERROR_DEVICE_REMOVED si l’appareil a été supprimé.

Remarques

Cette méthode n’est pas prise en charge par DXGI 1.0, fourni dans Windows Vista et Windows Server 2008. La prise en charge de DXGI 1.1 est requise, disponible sur Windows 7, Windows Server 2008 R2 et en tant que mise à jour de Windows Vista avec Service Pack 2 (SP2) (KB 971644) et Windows Server 2008 (Ko 971512).

La latence des images correspond au nombre d’images autorisées à être stockées dans une file d’attente avant la soumission pour le rendu. La latence est souvent utilisée pour contrôler la façon dont le processeur choisit entre répondre aux entrées utilisateur et aux images qui se trouvent dans la file d’attente de rendu. Il est souvent avantageux pour les applications qui n’ont pas d’entrée utilisateur (par exemple, la lecture vidéo) de mettre en file d’attente plus de 3 images de données.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	dxgi.h
Bibliothèque	DXGI.lib

Voir aussi

DXGI Interfaces

IDXGIDevice1

IDXGIDevice1 ::GetMaximumFrameLatency