Fonction D3D12SerializeVersionedRootSignature (d3d12.h)

Article
02/29/2024

Sérialise une signature racine de toute version qui peut être passée à ID3D12Device ::CreateRootSignature.

Syntaxe

HRESULT D3D12SerializeVersionedRootSignature(
  [in]            const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *pRootSignature,
  [out]           ID3DBlob                                  **ppBlob,
  [out, optional] ID3DBlob                                  **ppErrorBlob
);

Paramètres

[in] pRootSignature

Type : const D3D12_VERSIONED_ROOT_SIGNATURE_DESC*

Spécifie un D3D12_VERSIONED_ROOT_SIGNATURE_DESC qui contient une description de n’importe quelle version d’une signature racine.

[out] ppBlob

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.

[out, optional] ppErrorBlob

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 retournée

Type : HRESULT

Retourne S_OK en cas de réussite ; dans le cas contraire, 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 créer le formulaire sérialisé. L’application transmet ensuite le formulaire sérialisé vers lequel ppBlob pointe vers ID3D12Device ::CreateRootSignature.

Si un nuanceur a été créé avec une signature racine, le nuanceur compilé contient déjà une signature racine sérialisée. Dans ce cas, passez l’objet blob de nuanceur compilé à ID3D12Device ::CreateRootSignature pour obtenir l’objet de signature racine du runtime.

Notez que pour les développeurs Xbox, l’utilisation de signatures racines créées par HLSL est fortement recommandée.

Le PFN_D3D12_SERIALIZE_VERSIONED_ROOT_SIGNATURE de signature de fonction est fourni en tant que typedef, ce qui vous permet d’utiliser des techniques de liaison dynamique (GetProcAddress) au lieu d’une liaison statique.

Cette fonction a été publiée avec la mise à jour anniversaire Windows 10 (14393) et remplace D3D12SerializeRootSignature.