ID3D12StateObjectProperties::GetShaderIdentifier-Methode (d3d12.h)

  • Artikel

Ruft den eindeutigen Bezeichner für einen Shader ab, der in einem Shaderdatensatz verwendet werden kann.

Syntax

void * GetShaderIdentifier(
  LPCWSTR pExportName
);

Parameter

pExportName

Entrypoint im Zustandsobjekt, für das ein Bezeichner abgerufen werden soll.

Rückgabewert

Ein Zeiger auf den Shaderbezeichner.

Die Daten, auf die mit diesem Zeiger verwiesen wird, sind gültig, solange das Zustandsobjekt, aus dem es stammt, gültig ist. Die Größe der zurückgegebenen Daten ist D3D12_SHADER_IDENTIFIER_SIZE_IN_BYTES. Anwendungen sollten diese Daten kopieren und zwischenspeichern, um die Kosten für die Suche im Zustandsobjekt zu vermeiden, wenn sie mehrmals abgerufen werden müssen. Der Bezeichner wird in Shaderdatensätzen in Shadertabellen im GPU-Speicher verwendet, die die App auffüllen muss.

Die Daten selbst identifizieren den Shader global. Selbst wenn der Shader in einem anderen Zustandsobjekt mit den gleichen Zuordnungen wie alle Stammsignaturen angezeigt wird, weist er denselben Bezeichner auf.

Wenn der Shader im Zustandsobjekt nicht vollständig aufgelöst ist, lautet der Rückgabewert nullptr.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d12.h
Bibliothek D3D12.lib
DLL D3D12.dll

Weitere Informationen

ID3D12StateObjectProperties