ID3D12GraphicsCommandList::ResolveSubresource, méthode (d3d12.h)

Article
08/23/2023

Copiez une ressource à échantillonnage multiple dans une ressource non multi-échantillonnées.

Syntaxe

void ResolveSubresource(
  ID3D12Resource *pDstResource,
  UINT           DstSubresource,
  ID3D12Resource *pSrcResource,
  UINT           SrcSubresource,
  DXGI_FORMAT    Format
);

Paramètres

pDstResource

Type : [in] ID3D12Resource*

Ressource de destination. Doit être un créé sur un tas D3D12_HEAP_TYPE_DEFAULT et être échantillonné à un seul échantillon. Consultez ID3D12Resource.

DstSubresource

Type : [in] UINT

Index de base zéro qui identifie la sous-ressource de destination. Utilisez D3D12CalcSubresource pour calculer l’index de sous-ressource si la ressource parente est complexe.

pSrcResource

Type : [in] ID3D12Resource*

Ressource source. Doit être échantillonné plusieurs fois.

SrcSubresource

Type : [in] UINT

Sous-ressource source de la ressource source.

Format

Type : [in] DXGI_FORMAT

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

Valeur de retour

None

Notes

Couche de débogage

La couche de débogage génère une erreur si les sous-ressources référencées par la vue source ne sont pas dans l’état D3D12_RESOURCE_STATE_RESOLVE_SOURCE .

La couche de débogage émet une erreur si la mémoire tampon de destination n’est pas dans l’état D3D12_RESOURCE_STATE_RESOLVE_DEST .

Les ressources source et de destination doivent être du 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 que 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 (c’est-à-dire si les deux sont DXGI_FORMAT_R32_TYPELESS DXGI_FORMAT_R32_FLOAT peut être spécifié dans le paramètre Format). Par exemple, étant donné le 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

Spécifications


Plateforme cible	Windows
En-tête	d3d12.h
Bibliothèque	D3d12.lib
DLL	D3d12.dll

Voir aussi

ID3D12GraphicsCommandList

Sous-ressources