D3D12_RESOURCE_DESC1 (consoles XBOX Series)

Décrit une ressource, telle qu’une texture. Cette structure est largement utilisée.

Syntaxe

typedef struct D3D12_RESOURCE_DESC1 {  
    D3D12_RESOURCE_DIMENSION Dimension;  
    UINT64 Alignment;  
    UINT64 Width;  
    UINT Height;  
    UINT16 DepthOrArraySize;  
    UINT16 MipLevels;  
    DXGI_FORMAT Format;  
    DXGI_SAMPLE_DESC SampleDesc;  
    D3D12_TEXTURE_LAYOUT Layout;  
    D3D12_RESOURCE_FLAGS Flags;  
    D3D12_MIP_REGION SamplerFeedbackMipRegion;  
} D3D12_RESOURCE_DESC1  

Membres

Dimension
Type : D3D12_RESOURCE_DIMENSION Un membre de D3D12_RESOURCE_DIMENSION, qui spécifie les dimensions de la ressource (par exemple, D3D12_RESOURCE_DIMENSION_TEXTURE1D), ou s’il s’agit d’une mémoire tampon ((D3D12_RESOURCE_DIMENSION_BUFFER). Alignment
Type : UINT64 Spécifie l’alignement en octets. Width
Type : UINT64 Spécifie la largeur de la ressource. Height
Type : UINT Spécifie la hauteur de la ressource. DepthOrArraySize
Type : UINT16 Spécifie la profondeur de la ressource, si elle est 3D, ou la taille du tableau s’il s’agit d’un tableau de ressources 1D ou 2D. MipLevels
Type : UINT16 Spécifie le nombre de niveaux de MIP. Format
Type : DXGI_FORMAT Spécifie un membre de DXGI_FORMAT. SampleDesc
Type : DXGI_SAMPLE_DESC Spécifie une structure DXGI_SAMPLE_DESC. Layout
Type : D3D12_TEXTURE_LAYOUT Spécifie un membre de D3D12_TEXTURE_LAYOUT. Flags
Type : D3D12_RESOURCE_FLAGS Indicateurs combinés par OU au niveau du bit, sous forme de constantes d’énumération D3D12_RESOURCE_FLAGS. SamplerFeedbackMipRegion
Type : D3D12_MIP_REGION Pour une ressource de rétroaction d’échantillonneur, décrit la taille, dans la ressource suivie, représentée par un texel de rétroaction.

Remarques

Utilisez cette structure avec :

ID3D12Resource::GetDesc
ID3D12Device::GetResourceAllocationInfo
ID3D12Device::CreateCommittedResource
ID3D12Device::CreatePlacedResource
ID3D12Device::CreateReservedResource
ID3D12Device::GetCopyableFootprints

Pour un certain nombre de fonctions d’assistance, consultez Structures et fonctions d’assistance pour D3D12. Deux ressources courantes sont les mémoires tampons et les textures, qui utilisent toutes deux cette structure, mais avec des utilisations très différentes des champs.

Mémoires tampons

Les mémoires tampons sont une région de mémoire contiguë. Width peut être compris entre 1 et soit le champ MaxGPUVirtualAddressBitsPerResource de D3D12_FEATURE_DATA_GPU_VIRTUAL_ADDRESS_SUPPORT pour les ressources réservées, soit le champ MaxGPUVirtualAddressBitsPerProcess pour les ressources validées. Toutefois, l’épuisement de l’espace d’adressage virtuel du GPU, du budget de résidence en mémoire (voir IDXGIAdapter3::QueryVideoMemoryInfo) ou de la mémoire système peut facilement survenir en premier. Alignment doit être de 64 Ko (D3D12_DEFAULT_RESOURCE_PLACEMENT_ALIGNMENT) ou 0, ce qui équivaut en fait à 64 Ko. Height, DepthOrArraySize et MipLevels doivent être égaux à 1. Format doit être DXGI_FORMAT_UNKNOWN. SampleDesc.Count doit être égal à 1 et Quality doit être égal à 0. Layout doit être D3D12_TEXTURE_LAYOUT_ROW_MAJOR, car les dispositions de mémoire des mémoires tampons sont comprises par les applications et les données de texture en ordre ligne sont couramment transmises au moyen de mémoires tampons. Flags doit tout de même être rempli avec exactitude par les applications pour les mémoires tampons, à quelques exceptions près. Toutefois, les applications peuvent utiliser la plus grande prise en charge de capacités sans se soucier de l’incidence sur l’efficacité des mémoires tampons. Le champ Flags est destiné à contrôler les propriétés liées aux textures.

Textures

Les textures sont un agencement multidimensionnel de texels dans une région de mémoire contiguë, fortement optimisé pour maximiser la bande passante pour le rendu et l’échantillonnage. Les tailles de texture sont difficiles à prévoir et varient d’un adaptateur à l’autre. Les applications doivent utiliser ID3D12Device::GetResourceAllocationInfo pour connaître précisément leur taille. TEXTURE1D, TEXTURE2D et TEXTURE3D ne sont pas pris en charge de manière orthogonale sur tous les formats. Consultez l’utilisation de D3D12_FORMAT_SUPPORT1_TEXTURE1D, D3D12_FORMAT_SUPPORT1_TEXTURE2D et D3D12_FORMAT_SUPPORT1_TEXTURE3D dans D3D12_FORMAT_SUPPORT1. Width, Height et DepthOrArraySize doivent être compris entre 1 et la dimension maximale prise en charge pour le niveau de fonctionnalité et la dimension de texture en question. Toutefois, l’épuisement de l’espace d’adressage virtuel du GPU, du budget de résidence en mémoire (voir IDXGIAdapter3::QueryVideoMemoryInfo) ou de la mémoire système peut facilement survenir en premier. Pour les formats compressés, ces dimensions sont logiques. Par exemple :

Pour TEXTURE1D :
- Width doit être inférieur ou égal à D3D10_REQ_TEXTURE1D_U_DIMENSION aux niveaux de fonctionnalité inférieurs à 11_0 et à D3D11_REQ_TEXTURE1D_U_DIMENSION au niveau de fonctionnalité 11_0 ou supérieur.
- Height doit être égal à 1.
- DepthOrArraySize est interprété comme la taille du tableau et doit être inférieur ou égal à D3D10_REQ_TEXTURE1D_ARRAY_AXIS_DIMENSION aux niveaux de fonctionnalité inférieurs à 11_0 et à D3D11_REQ_TEXTURE1D_ARRAY_AXIS_DIMENSION aux niveaux de fonctionnalité 11_0 ou supérieurs.
Pour TEXTURE2D :
- Width et Height doivent être inférieurs ou égaux à D3D10_REQ_TEXTURE2D_U_OR_V_DIMENSION aux niveaux de fonctionnalité inférieurs à 11_0 et à D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION au niveau de fonctionnalité 11_0 ou supérieur.
- DepthOrArraySize est interprété comme la taille du tableau et doit être inférieur ou égal à D3D10_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION aux niveaux de fonctionnalité inférieurs à 11_0 et à D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION aux niveaux de fonctionnalité 11_0 ou supérieurs.
Pour TEXTURE3D :
- Width, Height et DepthOrArraySize doivent être inférieurs ou égaux à D3D10_REQ_TEXTURE3D_U_V_OR_W_DIMENSION aux niveaux de fonctionnalité inférieurs à 11_0 et à D3D11_REQ_TEXTURE2D_U_V_OR_W_DIMENSION au niveau de fonctionnalité 11_0 ou supérieur.
- DepthOrArraySize est interprété comme la profondeur.

Les remarques suivantes s’appliquent à toutes les tailles de texture.

Alignment

Alignment peut être 0, 4 Ko, 64 Ko ou 4 Mo. Si Alignment est défini à 0, le runtime utilisera 4 Mo pour les textures MSAA et 64 Ko pour tout le reste. L’application peut choisir des alignements plus petits que ces valeurs par défaut pour quelques types de textures lorsque la texture est petite. Les textures avec une disposition UNKNOWN et MSAA peuvent être créées avec un alignement de 64 Ko (si elles respectent la restriction de petite taille détaillée ci-dessous). Les textures avec une disposition UNKNOWN sans MSAA et sans indicateurs de cible de rendu ni de profondeur-gabarit peuvent être créées avec un Alignment de 4 Ko (là encore, en respectant la restriction de petite taille). Les applications peuvent créer des ressources avec un alignement plus petit lorsque la taille estimée du niveau de mip le plus détaillé totalise la restriction d’alignement la plus grande ou moins. Le runtime utilisera un mécanisme d’estimation de taille indépendant de l’architecture, qui imite la façon dont les ressources standard swizzle et en mosaïque D3D12 sont dimensionnées. Toutefois, les tailles de mosaïque correspondront à la restriction d’alignement la plus petite pour ces calculs. En prenant comme exemple une texture qui n’est ni cible de rendu ni profondeur-gabarit, le runtime supposera des formes de mosaïques presque équilatérales de 4 Ko et calculera le nombre de mosaïques nécessaires pour le niveau de mip le plus détaillé. Si le nombre de mosaïques est inférieur ou égal à 16, l’application peut créer une ressource alignée sur 4 Ko. Ainsi, un tableau tex2d avec mips, de n’importe quelle taille de tableau et de n’importe quel nombre de niveaux de mip, peut être de 4 Ko, tant que la largeur et la hauteur sont suffisamment petites pour le format et le MSAA en question.

MipLevels

MipLevels peut être 0, ou de 1 au nombre maximal de niveaux de mip pris en charge par les dimensions Width, Height et DepthOrArraySize. Lorsque 0 est utilisé, l’API calcule automatiquement le nombre maximal de niveaux de mip pris en charge et l’utilise. Cependant, certaines propriétés de ressource et de tas excluent les niveaux de mip; l’application doit donc spécifier la valeur 1. Consultez le champ D3D12_FORMAT_SUPPORT1_MIP de D3D12_FORMAT_SUPPORT1 pour connaître les restrictions propres à chaque format. Les ressources MSAA, les textures avec D3D12_RESOURCE_FLAG_ALLOW_CROSS_ADAPTER et les tas avec D3D12_HEAP_FLAG_ALLOW_DISPLAY excluent tous les niveaux de mip.

Format

Format doit être un format valide pris en charge au niveau de fonctionnalité du périphérique.

SampleDesc

Un SampleDesc.Count supérieur à 1 ou une valeur Quality non nulle ne sont pris en charge que pour TEXTURE2D et lorsque D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET ou D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL est défini. Les éléments suivants ne sont pas pris en charge :

D3D12_TEXTURE_LAYOUT_64KB_STANDARD_SWIZZLE,
D3D12_RESOURCE_FLAG_ALLOW_UNORDERED_ACCESS,
D3D12_RESOURCE_FLAG_ALLOW_SIMULTANEOUS_ACCESS,
D3D12_HEAP_FLAG_ALLOW_DISPLAY

Consultez D3D12_FEATURE_DATA_MULTISAMPLE_QUALITY_LEVELS pour déterminer les valeurs valides de Count et Quality.

Configuration requise

En-tête : d3d12_xs.h
Plateformes prises en charge : consoles XBOX Series

Voir aussi

Vue d’ensemble de l’API Direct3D 12 de rétroaction d’échantillonneur d3d12_xs

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Syntaxe

Membres

Remarques

Mémoires tampons

Textures

Alignment

MipLevels

Format

SampleDesc

Configuration requise

Voir aussi

​Syntaxe

​Membres

​Remarques

​Mémoires tampons

​Textures

​Alignment

​MipLevels

​Format

​SampleDesc

​Configuration requise

​Voir aussi

Syntaxe

Membres

Remarques

Mémoires tampons

Textures

Alignment

MipLevels

Format

SampleDesc

Configuration requise

Voir aussi