PFND3D12DDI_SHADERCACHEGETVALUE_CB_0021 funzione di callback (d3d12umddi.h)

La pfnShaderCacheGetValueCb funzione di callback ottiene un valore archiviato nella cache shader.

Sintassi

PFND3D12DDI_SHADERCACHEGETVALUE_CB_0021 Pfnd3d12ddiShadercachegetvalueCb0021;

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

Parametri

hRTDevice

[in] Handle per la rappresentazione del runtime del dispositivo.

hRTPSO

[in] Handle per la rappresentazione del runtime di un oggetto stato della pipeline.

pPrecomputedHash

[in] Struttura D3D12DDI_SHADERCACHE_HASH che contiene il valore hash da usare per la ricerca della cache.

pKey

[in] Puntatore alla chiave associata al valore da recuperare dalla cache dello shader del driver. La chiave identifica in modo univoco i dati dello shader nella cache.

KeyLen

[in] Lunghezza della chiave a cui pKey punta, in byte.

pValue

[out] Puntatore al codice dello shader compilato o ad altri dati associati allo shader identificato da pPrecomputedHash e pKey. Questo parametro può essere NULL se pValueLen è zero.

pValueLen

[in/out] Puntatore a una variabile che specifica la lunghezza del buffer a cui pValue punta, in byte. In input, questa variabile specifica le dimensioni del buffer. Nell'output specifica le dimensioni dei dati scritti nel buffer. Se pValueLen è impostato su zero e pValue è NULL, pfnShaderCacheGetValueCb deve scrivere il numero di byte necessari per i dati in una seconda chiamata. In caso contrario, se il buffer che pValue punta a è troppo piccolo, la funzione deve avere esito negativo.

Valore restituito

Se pfnShaderCacheGetValueCb ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni

I pfnShaderCacheStoreValueCb e pfnShaderCacheGetValueCb callback vengono usati per archiviare e recuperare il codice dello shader compilato o altri dati correlati allo shader nella cache dello shader del driver. La memorizzazione nella cache consente di migliorare le prestazioni riducendo la necessità di ricompilare shader già compilati e memorizzati nella cache.

Accedere a questo callback usando la struttura D3D12DDI_SHADERCACHE_CALLBACKS_0021.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	d3d12umddi.h (include D3d12umddi.h)

Vedere anche

D3D12DDI_SHADERCACHE_CALLBACKS_0021

pfnShaderCacheStoreValueCb