Método ID3D12VersionedRootSignatureDeserializer::GetRootSignatureDescAtVersion (d3d12.h)

  • Artículo

Convierte las estructuras de descripción de firma raíz en una versión solicitada.

Sintaxis

HRESULT GetRootSignatureDescAtVersion(
        D3D_ROOT_SIGNATURE_VERSION                convertToVersion,
  [out] const D3D12_VERSIONED_ROOT_SIGNATURE_DESC **ppDesc
);

Parámetros

convertToVersion

Tipo: D3D_ROOT_SIGNATURE_VERSION

Especifica el D3D_ROOT_SIGNATURE_VERSION necesario.

[out] ppDesc

Tipo: const D3D12_VERSIONED_ROOT_SIGNATURE_DESC**

Contiene la firma raíz deserializada en una estructura de D3D12_VERSIONED_ROOT_SIGNATURE_DESC .

Valor devuelto

Tipo: HRESULT

Este método devuelve un código de error o correcto HRESULT. El método puede producir un error con E_OUTOFMEMORY.

Comentarios

Este método asigna almacenamiento adicional si es necesario para la firma raíz convertida (memoria propiedad de la interfaz de deserializador). Si se realiza la conversión, la interfaz de deserializador no libera la memoria de firma raíz deserializada original: se pide a todas las versiones a las que se convierta la interfaz hasta que se destruya el deserializador.

La conversión de una firma raíz de 1.1 a 1.0 eliminará todas las D3D12_DESCRIPTOR_RANGE_FLAGS y D3D12_ROOT_DESCRIPTOR_FLAGS puede ser útil para generar firmas raíz compatibles que necesiten ejecutarse en sistemas operativos antiguos, aunque pierde oportunidades de optimización. Por ejemplo, se pueden serializar y almacenar varias versiones de firma raíz con recursos de aplicación, con la versión adecuada usada en tiempo de ejecución en función de las funcionalidades del sistema operativo.

La conversión de una firma raíz de 1.0 a 1.1 solo agrega las marcas adecuadas para que coincidan con la semántica 1.0.

Requisitos

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

Consulte también

ID3D12VersionedRootSignatureDeserializer

Versión 1.1 de la firma raíz