ID3D12GraphicsCommandList1 ::ResolveSubresourceRegion, méthode (d3d12.h)
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 |