ID3D11DeviceContext::ResolveSubresource, méthode (d3d11.h)

Article
08/22/2023

Copiez une ressource multi-échantillonnée dans une ressource non multi-échantillonnée.

Syntaxe

void ResolveSubresource(
  [in] ID3D11Resource *pDstResource,
  [in] UINT           DstSubresource,
  [in] ID3D11Resource *pSrcResource,
  [in] UINT           SrcSubresource,
  [in] DXGI_FORMAT    Format
);

Paramètres

[in] pDstResource

Type : ID3D11Resource*

Ressource de destination. Doit être un créé avec l’indicateur D3D11_USAGE_DEFAULT et être échantillonné à un seul échantillon. Consultez ID3D11Resource.

[in] DstSubresource

Type : UINT

Index de base zéro qui identifie la sous-ressource de destination. Utilisez D3D11CalcSubresource pour calculer l’index.

[in] pSrcResource

Type : ID3D11Resource*

Ressource source. Doit être multi-échantillonné.

[in] SrcSubresource

Type : UINT

Sous-ressource source de la ressource source.

[in] Format

Type : DXGI_FORMAT

Une DXGI_FORMAT qui indique comment la ressource multi-échantillonnée sera résolue en une ressource à échantillon unique. Consultez la section Remarques.

Valeur de retour

Aucune

Remarques

Cette API est particulièrement utile lors de la réutilisation du rendertarget résultant d’une passe de rendu en tant qu’entrée vers une deuxième passe de rendu.

Les ressources source et de destination doivent avoir le même type de ressource et avoir les mêmes dimensions. En outre, ils doivent avoir des formats compatibles. Il existe trois scénarios pour cela :

Scénario	Spécifications
La source et la destination sont préstructurées et typées	La source et la destination doivent avoir des formats identiques et ce format doit être spécifié dans le paramètre Format.
Une ressource est préstructurée et typée et l’autre est préstructurée et sans type	La ressource typée doit avoir un format compatible avec la ressource sans type (c’est-à-dire que la ressource typée est DXGI_FORMAT_R32_FLOAT et la ressource sans type est DXGI_FORMAT_R32_TYPELESS). Le format de la ressource typée doit être spécifié dans le paramètre Format.
La source et la destination sont préstructurées et sans type	La source et la destination doivent avoir le même format sans type (c’est-à-dire, les deux doivent avoir DXGI_FORMAT_R32_TYPELESS), et le paramètre Format doit spécifier un format compatible avec la source et la destination (par exemple, si les deux sont DXGI_FORMAT_R32_TYPELESS, DXGI_FORMAT_R32_FLOAT peut être spécifié dans le paramètre Format). Par exemple, compte tenu du format DXGI_FORMAT_R16G16B16A16_TYPELESS : Le format source (ou dest) peut être DXGI_FORMAT_R16G16B16A16_UNORM Le format dest (ou source) peut être DXGI_FORMAT_R16G16B16A16_FLOAT

Scénario

Spécifications

La source et la destination sont préstructurées et typées

La source et la destination doivent avoir des formats identiques et ce format doit être spécifié dans le paramètre Format.

Une ressource est préstructurée et typée et l’autre est préstructurée et sans type

La ressource typée doit avoir un format compatible avec la ressource sans type (c’est-à-dire que la ressource typée est DXGI_FORMAT_R32_FLOAT et la ressource sans type est DXGI_FORMAT_R32_TYPELESS). Le format de la ressource typée doit être spécifié dans le paramètre Format.

La source et la destination sont préstructurées et sans type

La source et la destination doivent avoir le même format sans type (c’est-à-dire, les deux doivent avoir DXGI_FORMAT_R32_TYPELESS), et le paramètre Format doit spécifier un format compatible avec la source et la destination (par exemple, si les deux sont DXGI_FORMAT_R32_TYPELESS, DXGI_FORMAT_R32_FLOAT peut être spécifié dans le paramètre Format).

Par exemple, compte tenu du format DXGI_FORMAT_R16G16B16A16_TYPELESS :

Le format source (ou dest) peut être DXGI_FORMAT_R16G16B16A16_UNORM
Le format dest (ou source) peut être DXGI_FORMAT_R16G16B16A16_FLOAT

Configuration requise


Plateforme cible	Windows
En-tête	d3d11.h
Bibliothèque	D3D11.lib

Voir aussi

ID3D11DeviceContext