Compartir a través de


Función D3D12SerializeVersionedRootSignature (d3d12.h)

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.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d12.h
Library D3d12.lib
Archivo DLL D3d12.dll

Consulte también

Funciones principales

Creación de una firma raíz

D3DX12SerializeVersionedRootSignature

Versión 1.1 de la firma raíz