PFND3D12DDI_SHADERCACHEGETVALUE_CB_0021 função de retorno de chamada (d3d12umddi.h)

Artigo
06/29/2024

A função de retorno de chamada pfnShaderCacheGetValueCb obtém um valor armazenado no cache do sombreador.

Sintaxe

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] Manipule para a representação do dispositivo no runtime.

hRTPSO

[in] Manipule para a representação do runtime de um objeto de estado de pipeline.

pPrecomputedHash

[in] Uma estrutura D3D12DDI_SHADERCACHE_HASH que contém o valor de hash a ser usado para pesquisa de cache.

pKey

[in] Um ponteiro para a chave associada ao valor a ser recuperado do cache de sombreador do driver. A chave identifica exclusivamente os dados do sombreador no cache.

KeyLen

[in] O comprimento da chave que pKey aponta para, em bytes.

pValue

[out] Um ponteiro para o código de sombreador compilado ou outros dados associados ao sombreador identificado por pPrecomputedHash e pKey. Esse parâmetro poderá ser NULL se pValueLen for zero.

pValueLen

[entrada/saída] Ponteiro para uma variável que especifica o comprimento do buffer que pValue aponta para, em bytes. Na entrada, essa variável especifica o tamanho do buffer. Na saída, ele especifica o tamanho dos dados que foram gravados no buffer. Se pValueLen estiver definido como zero e pValue for NULL, pfnShaderCacheGetValueCb deverá gravar o número de bytes necessários para os dados em uma segunda chamada para ele. Caso contrário, se o buffer que pValue apontar for muito pequeno, a função deverá falhar.

Valor de retorno

Se pfnShaderCacheGetValueCb for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

Os pfnShaderCacheStoreValueCb e pfnShaderCacheGetValueCb são usados para armazenar e recuperar código de sombreador compilado ou outros dados relacionados ao sombreador no cache do sombreador do driver. O cache ajuda a melhorar o desempenho, reduzindo a necessidade de recompilar sombreadores que já foram compilados e armazenados em cache.

Acesse esse retorno de chamada usando a estrutura D3D12DDI_SHADERCACHE_CALLBACKS_0021.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	d3d12umddi.h (inclua D3d12umddi.h)

Consulte também

D3D12DDI_SHADERCACHE_CALLBACKS_0021

pfnShaderCacheStoreValueCb

Compartilhar via