PFND3D12DDI_SHADERCACHEGETVALUE_CB_0021 fungsi panggilan balik (d3d12umddi.h)

Artikel
06/29/2024

Fungsi panggilan balik pfnShaderCacheGetValueCb mendapatkan nilai yang disimpan dalam cache shader.

Sintaksis

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

Parameter

hRTDevice

[di] Tangani ke representasi runtime perangkat.

hRTPSO

[di] Menangani representasi runtime objek status alur.

pPrecomputedHash

[di] Struktur D3D12DDI_SHADERCACHE_HASH yang berisi nilai hash yang akan digunakan untuk pencarian cache.

pKey

[di] Penunjuk ke kunci yang terkait dengan nilai yang akan diambil dari cache shader driver. Kunci secara unik mengidentifikasi data shader di cache.

KeyLen

[di] Panjang kunci yang pKey menunjuk ke, dalam byte.

pValue

[out] Penunjuk ke kode shader yang dikompilasi atau data lain yang terkait dengan shader yang diidentifikasi oleh pPrecomputedHash dan pKey. Parameter ini dapat berupa NULL jika pValueLen adalah nol.

pValueLen

[masuk/keluar] Penunjuk ke variabel yang menentukan panjang buffer yang pValue menunjuk ke, dalam byte. Pada input, variabel ini menentukan ukuran buffer. Pada output, ini menentukan ukuran data yang ditulis ke buffer. Jika pValueLen diatur ke nol dan pValue null, pfnShaderCacheGetValueCb harus menulis jumlah byte yang diperlukan untuk data dalam panggilan kedua ke dalamnya. Jika tidak, jika buffer yang pValue titik terlalu kecil, fungsi akan gagal.

Mengembalikan nilai

Jika pfnShaderCacheGetValueCb berhasil, S_OK. Jika tidak, kode kesalahan HRESULT.

Komentar

pfnShaderCacheStoreValueCb dan pfnShaderCacheGetValueCb callback digunakan untuk menyimpan dan mengambil kode shader yang dikompilasi atau data terkait shader lainnya dalam cache shader driver. Penembolokan membantu meningkatkan performa dengan mengurangi kebutuhan untuk mengkompilasi ulang shader yang telah dikompilasi dan di-cache.

Akses panggilan balik ini dengan menggunakan struktur D3D12DDI_SHADERCACHE_CALLBACKS_0021.

Persyaratan

Syarat	Nilai
Platform Target	Windows
Header	d3d12umddi.h (termasuk D3d12umddi.h)

Lihat juga

D3D12DDI_SHADERCACHE_CALLBACKS_0021

pfnShaderCacheStoreValueCb

Bagikan melalui