Syntaxe
Paramètres
NumDestDescriptorRanges [in]Type : UINT Le nombre de plages de descripteurs de destination vers lesquelles copier. pDestDescriptorRangeStarts [in]
Type : const D3D12_CPU_DESCRIPTOR_HANDLE * Un tableau d’objets D3D12_CPU_DESCRIPTOR_HANDLE vers lesquels copier. Tous les descripteurs de destination et de source doivent se trouver dans des tas du même D3D12_DESCRIPTOR_HEAP_TYPE. pDestDescriptorRangeSizes [in, optional]
Type : const UINT * Un tableau des tailles des plages de descripteurs de destination vers lesquelles copier. NumSrcDescriptorRanges [in]
Type : UINT Le nombre de plages de descripteurs sources à partir desquelles copier. pSrcDescriptorRangeStarts [in]
Type : const D3D12_CPU_DESCRIPTOR_HANDLE * Un tableau d’objets D3D12_CPU_DESCRIPTOR_HANDLE à partir desquels copier.
Tous les éléments du paramètre pSrcDescriptorRangeStarts doivent se trouver dans un tas de descripteurs non visible par les nuanceurs. En effet, les tas de descripteurs visibles par les nuanceurs peuvent être créés dans la mémoire WRITE_COMBINE ou dans la mémoire locale du GPU, dont la lecture est extrêmement lente. Si votre application gère les tas de descripteurs en copiant les descripteurs requis pour une passe ou une image donnée depuis des tas de descripteurs locaux de « stockage » vers le tas de descripteurs lié au GPU, utilisez des tas opaques aux nuanceurs pour les tas de stockage et copiez dans le tas visible par le GPU au besoin.
Type : const UINT * Un tableau des tailles des plages de descripteurs sources à partir desquelles copier. DescriptorHeapsType [in]
Type : D3D12_DESCRIPTOR_HEAP_TYPE La valeur de type D3D12_DESCRIPTOR_HEAP_TYPE qui spécifie le type de tas de descripteurs utilisé pour la copie. Cela est requis, car différents types de descripteurs peuvent avoir des tailles différentes. Les tas de descripteurs source et de destination doivent être du même type, sinon la couche de débogage émettra une erreur.
Valeur de retour
Type : void Aucune.Remarques
Lorsque cela est applicable, préférez ID3D12Device::CopyDescriptorsSimple à cette méthode. Elle peut présenter un meilleur taux d’échecs de cache du processeur grâce à la nature linéaire de la copie.Configuration requise
En-tête : d3d12_xs.h ou d3d12_x.hBibliothèque : d3d12_xs.lib ou d3d12_x.lib
Plateformes prises en charge : consoles XBOX Series et famille XBOX One