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 de réussite ou d’erreur HRESULT. La méthode peut échouer avec E_OUTOFMEMORY.

Remarques

Cette méthode alloue au besoin de l’espace de stockage supplémentaire pour la signature racine convertie (mémoire appartenant à l’interface du désérialiseur). Si une conversion est effectuée, l’interface du désérialiseur 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 été invitée à convertir restent disponibles jusqu’à la destruction du désérialiseur. La conversion d’une signature racine de 1.1 vers 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 qui doivent s’exécuter sur d’anciens systèmes d’exploitation, mais elle fait perdre des possibilités d’optimisation. Par exemple, plusieurs versions de signatures racines 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 1.0 vers 1.1 ajoute simplement les indicateurs appropriés pour correspondre à la sémantique de 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