IDXGISwapChain ::ResizeTarget, méthode (dxgi.h)

  • Article

Redimensionne la cible de sortie.

Syntaxe

HRESULT ResizeTarget(
  [in] const DXGI_MODE_DESC *pNewTargetParameters
);

Paramètres

[in] pNewTargetParameters

Type : const DXGI_MODE_DESC*

Pointeur vers une structure de DXGI_MODE_DESC qui décrit le mode, qui spécifie la nouvelle largeur, la hauteur, le format et la fréquence d’actualisation de la cible. Si le format est DXGI_FORMAT_UNKNOWN, ResizeTarget utilise le format existant. Nous vous recommandons d’utiliser DXGI_FORMAT_UNKNOWN uniquement lorsque la chaîne d’échange est en mode plein écran, car cette méthode n’est pas thread safe.

Valeur retournée

Type : HRESULT

Retourne un code qui indique la réussite ou l’échec. DXGI_STATUS_MODE_CHANGE_IN_PROGRESS est retourné si une transition en mode plein écran/fenêtré se produit lors de l’appel de cette API. Consultez DXGI_ERROR pour obtenir des codes d’erreur DXGI supplémentaires.

Remarques

ResizeTarget redimensionne la fenêtre cible lorsque la chaîne d’échange est en mode fenêtré et modifie le mode d’affichage sur la sortie cible lorsque la chaîne d’échange est en mode plein écran. Par conséquent, les applications peuvent appeler ResizeTarget pour redimensionner la fenêtre cible (plutôt qu’un Microsoft Win32API tel que SetWindowPos) sans connaître le mode d’affichage de la chaîne d’échange.

Si une application du Windows Store appelle ResizeTarget, elle échoue avec DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

Vous ne pouvez pas appeler ResizeTarget sur une chaîne d’échange que vous avez créée avec IDXGIFactory2 ::CreateSwapChainForComposition.

Les applications doivent toujours appeler IDXGISwapChain ::ResizeBuffers après avoir appelé ResizeTarget , car seuls ResizeBuffers peuvent modifier les mémoires tampons arrière. Toutefois, si ces applications ont implémenté le traitement de redimensionnement de fenêtre pour appeler ResizeBuffers, elles n’ont pas besoin d’appeler explicitement ResizeBuffers après avoir appelé ResizeTarget , car le traitement du redimensionnement de fenêtre permet d’atteindre ce dont l’application a besoin.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête dxgi.h
Bibliothèque DXGI.lib

Voir aussi

IDXGISwapChain