Passer au contenu principal
Sérialise une signature racine de n’importe quelle version qui peut être passée à ID3D12Device::CreateRootSignature.

​
Syntaxe

​
Paramètres

pRootSignature [in]
Type : const D3D12_VERSIONED_ROOT_SIGNATURE_DESC * Spécifie une D3D12_VERSIONED_ROOT_SIGNATURE_DESC qui contient une description de n’importe quelle version d’une signature racine. ppBlob [out]
Type : ID3DBlob ** Pointeur vers un bloc de mémoire qui reçoit un pointeur vers l’interface ID3DBlob que vous pouvez utiliser pour accéder à la signature racine sérialisée. ppErrorBlob [out, optional]
Type : ID3DBlob ** Pointeur vers un bloc de mémoire qui reçoit un pointeur vers l’interface ID3DBlob que vous pouvez utiliser pour accéder aux messages d’erreur du sérialiseur, ou NULL s’il n’y a aucune erreur.

​
Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite; sinon, retourne l’un des codes de retour Direct3D 12.

​
Remarques

Si une application génère de manière procédurale une structure de données D3D12_ROOT_SIGNATURE_DESC1, elle doit passer un pointeur vers cette D3D12_ROOT_SIGNATURE_DESC1 dans un appel à D3D12SerializeVersionedRootSignature pour produire la forme sérialisée. L’application passe ensuite la forme sérialisée vers laquelle pointe ppBlob à ID3D12Device::CreateRootSignature. Si un nuanceur a été créé avec une signature racine intégrée, le nuanceur compilé contiendra déjà une signature racine sérialisée. Dans ce cas, passez le blob du nuanceur compilé à ID3D12Device::CreateRootSignature pour obtenir l’objet de signature racine du runtime.
Pour les développeurs XBOX, l’utilisation de signatures racines créées en HLSL est fortement recommandée.
La signature de fonction PFN_D3D12_SERIALIZE_VERSIONED_ROOT_SIGNATURE est fournie sous forme de typedef, afin que vous puissiez utiliser des techniques de liaison dynamique (GetProcAddress) au lieu d’une liaison statique. Cette fonction a été publiée avec la mise à jour anniversaire de Windows 10 (14393) et remplace D3D12SerializeRootSignature.

​
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

Fonctions principales Création d’une signature racine D3DX12SerializeVersionedRootSignature Signature racine version 1.1
Dernière modification le 6 octobre 2026

Sujets connexes

D3D12_VERSIONED_ROOT_SIGNATURE_DESCD3D12SerializeRootSignatureD3D12CreateVersionedRootSignatureDeserializerID3D12VersionedRootSignatureDeserializerID3D12RootSignatureDeserializer