Passer au contenu principal
Convertit les structures de description de signature racine vers une version demandée.

Syntaxe

Paramètres

convertToVersion
Type : D3D_ROOT_SIGNATURE_VERSION
Spécifie la D3D_ROOT_SIGNATURE_VERSION requise. ppDesc [out]
Type : const D3D12_VERSIONED_ROOT_SIGNATURE_DESC **
Contient la signature racine désérialisée dans une structure D3D12_VERSIONED_ROOT_SIGNATURE_DESC.

Valeur de retour

Type : HRESULT Cette méthode retourne un code HRESULT de réussite ou d’erreur. La méthode peut échouer avec E_OUTOFMEMORY.

Remarques

Cette méthode alloue si nécessaire un stockage supplémentaire pour la signature racine convertie (mémoire appartenant à l’interface de désérialisation). Si une conversion est effectuée, l’interface de désérialisation ne libère pas la mémoire de la signature racine désérialisée d’origine : toutes les versions vers lesquelles l’interface a dû effectuer une conversion restent disponibles jusqu’à la destruction du désérialiseur. La conversion d’une signature racine de la version 1.1 vers la version 1.0 supprime tous les D3D12_DESCRIPTOR_RANGE_FLAGS et D3D12_ROOT_DESCRIPTOR_FLAGS ; elle peut être utile pour générer des signatures racines compatibles devant s’exécuter sur d’anciens systèmes d’exploitation, mais fait perdre des possibilités d’optimisation. Par exemple, plusieurs versions de signature racine peuvent être sérialisées et stockées avec les ressources de l’application, la version appropriée étant utilisée au moment de l’exécution en fonction des capacités du système d’exploitation. La conversion d’une signature racine de la version 1.0 vers la version 1.1 ajoute simplement les indicateurs appropriés pour correspondre à la sémantique de la version 1.0.

Configuration requise

En-tête : d3d12_xs.h ou d3d12_x.h
Bibliothèque : d3d12_xs.lib ou d3d12_x.lib
Plateformes prises en charge : consoles XBOX Series et famille XBOX One

Voir aussi

ID3D12VersionedRootSignatureDeserializer Signature racine version 1.1
Dernière modification le 6 octobre 2026