Función D3D12SerializeVersionedRootSignature (d3d12.h)

Artículo
08/23/2023

Serializa una firma raíz de cualquier versión que se pueda pasar a ID3D12Device::CreateRootSignature.

Sintaxis

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

Parámetros

[in] pRootSignature

Tipo: const D3D12_VERSIONED_ROOT_SIGNATURE_DESC*

Especifica un D3D12_VERSIONED_ROOT_SIGNATURE_DESC que contiene una descripción de cualquier versión de una firma raíz.

[out] ppBlob

Tipo: ID3DBlob**

Puntero a un bloque de memoria que recibe un puntero a la interfaz ID3DBlob que puede usar para acceder a la firma raíz serializada.

[out, optional] ppErrorBlob

Tipo: ID3DBlob**

Puntero a un bloque de memoria que recibe un puntero a la interfaz ID3DBlob que puede usar para acceder a los mensajes de error del serializador o NULL si no hay errores.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve uno de los códigos de retorno de Direct3D 12.

Comentarios

Si una aplicación genera de forma procedimental una estructura de datos D3D12_ROOT_SIGNATURE_DESC1 , debe pasar un puntero a este D3D12_ROOT_SIGNATURE_DESC1 en una llamada a D3D12SerializeVersionedRootSignature para convertir el formulario serializado. A continuación, la aplicación pasa el formulario serializado al que ppBlob apunta a ID3D12Device::CreateRootSignature.

Si se ha creado un sombreador con una firma raíz en él, el sombreador compilado contendrá una firma raíz serializada en ella. En este caso, pase el blob del sombreador compilado a ID3D12Device::CreateRootSignature para obtener el objeto de firma raíz en tiempo de ejecución.

Tenga en cuenta que, para los desarrolladores de Xbox, se recomienda encarecidamente el uso de firmas raíz creadas por HLSL.

La firma de función PFN_D3D12_SERIALIZE_VERSIONED_ROOT_SIGNATURE se proporciona como definición de tipo, para que pueda usar técnicas de vinculación dinámica (GetProcAddress) en lugar de vincular estáticamente.

Esta función se publicó con la actualización de aniversario de Windows 10 (14393) y sustituye a D3D12SerializeRootSignature.