ID3D12VersionedRootSignatureDeserializer::GetRootSignatureDescAtVersion-Methode (d3d12.h)

  • Artikel

Konvertiert Stammsignaturbeschreibungsstrukturen in eine angeforderte Version.

Syntax

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

Parameter

convertToVersion

Typ: D3D_ROOT_SIGNATURE_VERSION

Gibt die erforderliche D3D_ROOT_SIGNATURE_VERSION an.

[out] ppDesc

Typ: const D3D12_VERSIONED_ROOT_SIGNATURE_DESC**

Enthält die deserialisierte Stammsignatur in einer D3D12_VERSIONED_ROOT_SIGNATURE_DESC-Struktur .

Rückgabewert

Typ: HRESULT

Diese Methode gibt einen HRESULT-Erfolgs- oder Fehlercode zurück. Die -Methode kann mit E_OUTOFMEMORY fehlschlagen.

Hinweise

Diese Methode weist bei Bedarf zusätzlichen Speicher für die konvertierte Stammsignatur zu (Arbeitsspeicher im Besitz der Deserialisierungsschnittstelle). Wenn die Konvertierung erfolgt, gibt die Deserialisierungsschnittstelle den ursprünglichen deserialisierten Stammsignaturspeicher nicht frei. Alle Versionen, in die die Schnittstelle konvertiert wurde, sind verfügbar, bis der Deserialisierer zerstört wird.

Beim Konvertieren einer Stammsignatur von 1.1 in 1.0 werden alle D3D12_DESCRIPTOR_RANGE_FLAGS gelöscht, und D3D12_ROOT_DESCRIPTOR_FLAGS kann nützlich sein, um kompatible Stammsignaturen zu generieren, die auf alten Betriebssystemen ausgeführt werden müssen, obwohl optimierungsmöglichkeiten verloren gehen. Für instance können mehrere Stammsignaturversionen serialisiert und mit Anwendungsressourcen gespeichert werden, wobei die entsprechende Version zur Laufzeit basierend auf den Betriebssystemfunktionen verwendet wird.

Beim Konvertieren einer Stammsignatur von 1.0 in 1.1 werden nur die entsprechenden Flags hinzugefügt, die der Semantik von 1.0 entsprechen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d12.h
Bibliothek D3d12.lib
DLL D3d12.dll

Weitere Informationen

ID3D12VersionedRootSignatureDeserializer

Stammsignatur, Version 1.1