PFND3D12DDI_SHADERCACHEGETVALUE_CB_0021 función de devolución de llamada (d3d12umddi.h)

La función de devolución de llamada pfnShaderCacheGetValueCb obtiene un valor almacenado en la caché del sombreador.

Sintaxis

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
)
{...}

Parámetros

hRTDevice

[in] Controle la representación del dispositivo en tiempo de ejecución.

hRTPSO

[in] Controlar la representación del tiempo de ejecución de un objeto de estado de canalización.

pPrecomputedHash

[in] Estructura D3D12DDI_SHADERCACHE_HASH que contiene el valor hash que se va a usar para la búsqueda de caché.

pKey

[in] Puntero a la clave asociada al valor que se va a recuperar de la caché del sombreador del controlador. La clave identifica de forma única los datos del sombreador en la memoria caché.

KeyLen

[in] Longitud de la clave a la que pKey apunta, en bytes.

pValue

[out] Puntero al código del sombreador compilado u otros datos asociados al sombreador identificado por pPrecomputedHash y pKey. Este parámetro puede ser NULL si pValueLen es cero.

pValueLen

[in/out] Puntero a una variable que especifica la longitud del búfer que pValue apunta, en bytes. En la entrada, esta variable especifica el tamaño del búfer. En la salida, especifica el tamaño de los datos escritos en el búfer. Si pValueLen se establece en cero y pValue es NULL, pfnShaderCacheGetValueCb debe escribir el número de bytes necesarios para los datos en una segunda llamada. De lo contrario, si el búfer que pValue apunta a es demasiado pequeño, la función debe producir un error.

Valor devuelto

Si pfnShaderCacheGetValueCb se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Observaciones

El pfnShaderCacheStoreValueCb de y pfnShaderCacheGetValueCb se usan para almacenar y recuperar código de sombreador compilado u otros datos relacionados con el sombreador en la caché del sombreador del controlador. El almacenamiento en caché ayuda a mejorar el rendimiento al reducir la necesidad de volver a compilar los sombreadores que ya se han compilado y almacenado en caché.

Acceda a esta devolución de llamada mediante la estructura D3D12DDI_SHADERCACHE_CALLBACKS_0021.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	d3d12umddi.h (incluya D3d12umddi.h)

Consulte también

D3D12DDI_SHADERCACHE_CALLBACKS_0021

pfnShaderCacheStoreValueCb