IDXGISwapChain ::P resent, méthode (dxgi.h)
Présente une image rendue à l’utilisateur.
Syntaxe
HRESULT Present(
UINT SyncInterval,
UINT Flags
);
Paramètres
SyncInterval
Type : UINT
Entier qui spécifie comment synchroniser la présentation d’un cadre avec le vide vertical.
Pour le modèle de transfert de bloc binaire (bitblt ) (DXGI_SWAP_EFFECT_DISCARD ou DXGI_SWAP_EFFECT_SEQUENTIAL), les valeurs sont les suivantes :
- 0 - La présentation se produit immédiatement, il n’y a aucune synchronisation.
- 1 à 4 - Synchroniser la présentation après le nièmevide vertical.
- 0 : annulez le temps restant sur l’image présentée précédemment et ignorez cette trame si une image plus récente est mise en file d’attente.
- 1 à 4 : synchroniser la présentation pour au moins n espaces verticaux.
Si la région de mise à jour est à cheval sur plusieurs sorties (chacune représentée par IDXGIOutput), Present effectue la synchronisation avec la sortie qui contient le plus grand sous-rectangle de la zone cliente de la fenêtre cible.
Flags
Type : UINT
Valeur entière qui contient les options de présentation de la chaîne d’échange. Ces options sont définies par les constantes DXGI_PRESENT .
Valeur retournée
Type : HRESULT
Les valeurs de retour possibles sont les suivantes : S_OK, DXGI_ERROR_DEVICE_RESET ou DXGI_ERROR_DEVICE_REMOVED (voir DXGI_ERROR), DXGI_STATUS_OCCLUDED (voir DXGI_STATUS) ou D3DDDIERR_DEVICEREMOVED.
Remarques
À compter de Direct3D 11.1, envisagez d’utiliser IDXGISwapChain1 ::P resent1, car vous pouvez ensuite utiliser sale rectangles et le rectangle de défilement dans la présentation de la chaîne d’échange et, par conséquent, utiliser moins de bande passante mémoire et, par conséquent, moins de puissance du système. Pour plus d’informations sur l’utilisation de rectangles sale et le rectangle de défilement dans la présentation de la chaîne d’échange, consultez Utilisation de rectangles sale et du rectangle de défilement dans la présentation de la chaîne d’échange.
Pour obtenir de meilleures performances lors du basculement des mémoires tampons de chaîne d’échange dans une application plein écran, consultez Indicateurs de performances des applications plein écran.
Étant donné que l’appel de Present peut entraîner l’attente du thread de rendu sur le thread de pompe de messages, soyez prudent lorsque vous appelez cette méthode dans une application qui utilise plusieurs threads. Pour plus d’informations, consultez Considérations relatives au multithreading.
|
Différences entre Direct3D 9 et Direct3D 10 : La spécification de DXGI_PRESENT_TEST dans le paramètre Flags est analogue à IDirect3DDevice9 ::TestCooperativeLevel dans Direct3D 9. |
Pour les chaînes d’échange de modèle de présentation inversées que vous créez avec le DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL ou DXGI_SWAP_EFFECT_DISCARD jeu de valeurs, une présentation réussie dissocie la mémoire tampon 0 (généralement définie par OMSetRenderTargets) du pipeline graphique, sauf lorsque vous passez l’indicateur DXGI_PRESENT_DO_NOT_SEQUENCE dans le paramètre Flags .
Pour plus d’informations sur la façon dont les valeurs de données changent lorsque vous présentez du contenu à l’écran, consultez Conversion de données pour l’espace de couleurs.
File d’attente du modèle de présentation flip
Supposons que les images suivantes avec des valeurs d’intervalle de synchronisation soient mises en file d’attente du plus ancien (A) au plus récent (E) avant d’appeler Present.A : 3, B : 0, C : 0, D : 1, E : 0
Lorsque vous appelez Present, le runtime affiche l’image A pour un seul intervalle vide vertical. Le runtime termine l’image A tôt en raison de l’intervalle de synchronisation 0 dans l’image B. Ensuite, le runtime affiche l’image D pour un intervalle vide vertical, puis l’image E jusqu’à ce que vous envoyiez une nouvelle présentation. Le runtime ignore les trames B et C.
Taux d’actualisation variable affiché
Il est nécessaire que la vitesse de rafraîchissement variable affiche que la déchirure soit activée. La méthode CheckFeatureSupport peut être utilisée pour déterminer si cette fonctionnalité est disponible. Pour définir les indicateurs requis, reportez-vous aux descriptions des DXGI_PRESENT_ALLOW_TEARING et des DXGI_SWAP_CHAIN_FLAG_ALLOW_TEARING, ainsi qu’à l’affichage de la fréquence d’actualisation variable.Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | dxgi.h |
| Bibliothèque | DXGI.lib |