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 memoria 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] Controle la representación del tiempo de ejecución de un objeto de estado de canalización.

pPrecomputedHash

[in] Estructura de 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 memoria 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 apunta pKey , 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 al 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 a él. De lo contrario, si el búfer al que apunta pValue es demasiado pequeño, se producirá un error en la función.

Valor devuelto

Si esta función de devolución de llamada se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Las devoluciones de llamada pfnShaderCacheStoreValueCb y pfnShaderCacheGetValueCb se usan para almacenar y recuperar código de sombreador compilado u otros datos relacionados con el sombreador en la memoria 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	Value
Plataforma de destino	Windows
Encabezado	d3d12umddi.h (incluya D3d12umddi.h)

Consulte también

D3D12DDI_SHADERCACHE_CALLBACKS_0021

pfnShaderCacheStoreValueCb