ID3D12GraphicsCommandList1 ::ResolveSubresourceRegion, méthode (d3d12.h)

  • Article

Copiez une région d’une ressource multi-échantillonnée ou compressée dans une ressource non multi-échantillonnée ou non compressée.

Syntaxe

void ResolveSubresourceRegion(
  [in]           ID3D12Resource     *pDstResource,
  [in]           UINT               DstSubresource,
  [in]           UINT               DstX,
  [in]           UINT               DstY,
  [in]           ID3D12Resource     *pSrcResource,
  [in]           UINT               SrcSubresource,
  [in, optional] D3D12_RECT         *pSrcRect,
  [in]           DXGI_FORMAT        Format,
  [in]           D3D12_RESOLVE_MODE ResolveMode
);

Paramètres

[in] pDstResource

Type : ID3D12Resource*

SAL : In

Ressource de destination. Doit être créé avec l’indicateur D3D11_USAGE_DEFAULT et doit être échantillonné à un seul échantillon, sauf s’il doit être résolu à partir d’une ressource compressée (D3D12_RESOLVE_MODE_DECOMPRESS) ; dans ce cas, il doit avoir le même nombre d’échantillons que la source compressée.

[in] DstSubresource

Type : UINT

SAL : In

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.

[in] DstX

Type : UINT

SAL : In

Coordonnée X du bord le plus à gauche de la région de destination. La largeur de la région de destination est identique à la largeur du rect source.

[in] DstY

Type : UINT

SAL : In

Coordonnée Y du bord le plus haut de la région de destination. La hauteur de la région de destination est identique à la hauteur de la rect source.

[in] pSrcResource

Type : ID3D12Resource*

SAL : In

Ressource source. Doit être multiéchantillonné ou compressé.

[in] SrcSubresource

Type : UINT

SAL : In

Index de base zéro qui identifie la sous-ressource source.

[in, optional] pSrcRect

Type : D3D12_RECT*

SAL : In_opt

Spécifie la région rectangulaire de la ressource source à résoudre. La transmission de la valeur NULL pour pSrcRect spécifie que la sous-ressource entière doit être résolue.

[in] Format

Type : DXGI_FORMAT

SAL : In

Une DXGI_FORMAT qui spécifie la façon dont les formats de ressources source et de destination sont consolidés.

[in] ResolveMode

Type : D3D12_RESOLVE_MODE

SAL : In

Spécifie l’opération utilisée pour résoudre les exemples sources.

Lors de l’utilisation de l’opération de D3D12_RESOLVE_MODE_DECOMPRESS , le nombre d’échantillons peut être supérieur à 1 tant que la source et la destination ont le même nombre d’échantillons, et que la source et la destination peuvent spécifier la même ressource tant que la rect source s’aligne sur les coordonnées X et Y de destination, auquel cas la décompression se produit en place.

Lorsque vous utilisez l’opération D3D12_RESOLVE_MODE_MIN, D3D12_RESOLVE_MODE_MAX ou D3D12_RESOLVE_MODE_AVERAGE , la destination doit avoir un nombre d’exemples de 1.

Valeur de retour

None

Remarques

ResolveSubresourceRegion fonctionne comme ResolveSubresource , mais permet de résoudre uniquement une partie d’une ressource et de résoudre les exemples sources de plusieurs manières. Les résolutions partielles peuvent être utiles dans les scénarios multi-adaptateurs ; par exemple, lorsque la zone rendue a été partitionnée entre des adaptateurs, chaque adaptateur peut avoir uniquement besoin de résoudre la partie d’une sous-ressource qui correspond à sa partition affectée.

Configuration requise

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

Voir aussi

ID3D12GraphicsCommandList1