PFND3D12DDI_SHADERCACHESTOREVALUE_CB_0021 Rückruffunktion (d3d12umddi.h)

  • Artikel

Die Rückruffunktion pfnShaderCacheStoreValueCb speichert einen Wert im Shadercache.

Syntax

PFND3D12DDI_SHADERCACHESTOREVALUE_CB_0021 Pfnd3d12ddiShadercachestorevalueCb0021;

HRESULT Pfnd3d12ddiShadercachestorevalueCb0021(
  D3D12DDI_HRTDEVICE hRTDevice,
  D3D12DDI_HRTPIPELINESTATE hRTPSO,
  const D3D12DDI_SHADERCACHE_HASH *pPrecomputedHash,
  const void *pKey,
  SIZE_T KeyLen,
  const void *pValue,
  SIZE_T ValueLen
)
{...}

Parameter

hRTDevice

[in] Behandeln Sie die Darstellung des Geräts durch die Runtime.

hRTPSO

[in] Handle mit der Darstellung eines Pipelinezustandsobjekts der Runtime.

pPrecomputedHash

[in] Zeiger auf eine D3D12DDI_SHADERCACHE_HASH-Struktur , die einen vorberechneten Hashwert enthält, der für das Einfügen des Caches verwendet wird.

pKey

[in] Ein Zeiger auf den Schlüssel, der dem Wert zugeordnet ist, der im Shadercache des Treibers gespeichert werden soll. Der Schlüssel identifiziert eindeutig die Shaderdaten im Cache.

KeyLen

[in] Die Länge des Schlüssels, auf den pKey in Bytes verweist.

pValue

[in] Ein Zeiger auf die Daten, die im Shadercache gespeichert werden sollen.

ValueLen

[in] Die Länge des Puffers, auf den pValue zeigt, in Bytes.

Rückgabewert

Wenn diese Rückruffunktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Rückrufe pfnShaderCacheStoreValueCb und pfnShaderCacheGetValueCb werden verwendet, um kompilierten Shadercode oder andere shaderbezogene Daten im Shadercache des Treibers zu speichern und abzurufen. Die Zwischenspeicherung trägt zur Verbesserung der Leistung bei, indem die Notwendigkeit verringert wird, Shader neu zu kompilieren, die bereits kompiliert und zwischengespeichert wurden.

Greifen Sie mithilfe der D3D12DDI_SHADERCACHE_CALLBACKS_0021-Struktur auf diesen Rückruf zu.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d12umddi.h (einschließlich D3d12umddi.h)

Weitere Informationen

D3D12DDI_SHADERCACHE_CALLBACKS_0021

pfnShaderCacheGetValueCb