Funzione D3D12SerializeVersionedRootSignature (d3d12.h)

Articolo
02/29/2024

Serializza una firma radice di qualsiasi versione che può essere passata a ID3D12Device::CreateRootSignature.

Sintassi

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

Parametri

[in] pRootSignature

Tipo: const D3D12_VERSIONED_ROOT_SIGNATURE_DESC*

Specifica un D3D12_VERSIONED_ROOT_SIGNATURE_DESC che contiene una descrizione di qualsiasi versione di una firma radice.

[out] ppBlob

Tipo: ID3DBlob**

Puntatore a un blocco di memoria che riceve un puntatore all'interfaccia ID3DBlob che è possibile usare per accedere alla firma radice serializzata.

[out, optional] ppErrorBlob

Tipo: ID3DBlob**

Puntatore a un blocco di memoria che riceve un puntatore all'interfaccia ID3DBlob che è possibile usare per accedere ai messaggi di errore del serializzatore oppure NULL se non sono presenti errori.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo; in caso contrario, restituisce uno dei codici restituiti Direct3D 12.

Commenti

Se un'applicazione genera in modo procedurale una struttura di dati D3D12_ROOT_SIGNATURE_DESC1 , deve passare un puntatore a questo D3D12_ROOT_SIGNATURE_DESC1 in una chiamata a D3D12SerializeVersionedRootSignature per creare il form serializzato. L'applicazione passa quindi il modulo serializzato a cui ppBlob punta in ID3D12Device::CreateRootSignature.

Se uno shader è stato creato con una firma radice, lo shader compilato conterrà già una firma radice serializzata. In questo caso, passare il BLOB shader compilato a ID3D12Device::CreateRootSignature per ottenere l'oggetto firma radice del runtime.

Si noti che per gli sviluppatori Xbox è consigliabile usare le firme radice create da HLSL.

La firma della funzione PFN_D3D12_SERIALIZE_VERSIONED_ROOT_SIGNATURE viene fornita come typedef, in modo da poter usare tecniche di collegamento dinamico (GetProcAddress) invece di collegarsi in modo statico.

Questa funzione è stata rilasciata con l'aggiornamento dell'anniversario Windows 10 (14393) e sostituisce D3D12SerializeRootSignature.