PFND3D11_1DDI_ASSIGNDEBUGBINARY fungsi panggilan balik (d3d10umddi.h)

Artikel
02/22/2024

Menyediakan biner shader lengkap yang tersedia setelah pembuatan shader. Biner shader penuh memungkinkan driver mengambil informasi penelusuran kesalahan atau informasi biner shader lainnya yang biasanya tidak akan tersedia untuk driver.

Sintaks

PFND3D11_1DDI_ASSIGNDEBUGBINARY Pfnd3d111DdiAssigndebugbinary;

void Pfnd3d111DdiAssigndebugbinary(
       D3D10DDI_HDEVICE unnamedParam1,
       D3D10DDI_HSHADER unnamedParam2,
       UINT uBinarySize,
  [in] const VOID *pBinary
)
{...}

Parameter

unnamedParam1

hDevice [in]

Handel ke perangkat tampilan (konteks grafis).

unnamedParam2

hShader [in]

Handel ke data pribadi driver untuk objek shader.

uBinarySize

Ukuran, dalam byte, dari biner shader penuh.

[in] pBinary

Penunjuk ke biner shader penuh.

Menampilkan nilai

Tidak ada

Keterangan

Driver dapat menggunakan fungsi panggilan balik pfnSetErrorCb untuk mengatur kode kesalahan.

AssignDebugBinary dipanggil hanya jika semua hal berikut ini benar:

Perangkat dapat di-debug.
Driver tampilan mode pengguna telah mengatur D3D11_1DDI_D3D11_OPTIONS_DATA. Tetapkan bendera AssignDebugBinarySupport ke TRUE.
Fungsi pembuatan shader CreateXxxShaderXxx telah dipanggil, telah berhasil, dan telah mengembalikan handel ke shader.

Driver tidak boleh mengalami kesalahan apa pun, kecuali untuk D3DDDIERR_DEVICEREMOVED. Oleh karena itu, jika driver melewati kesalahan apa pun, kecuali untuk D3DDDIERR_DEVICEREMOVED, dalam panggilan ke fungsi pfnSetErrorCb , runtime Microsoft Direct3D akan menentukan bahwa kesalahan sangat penting. Bahkan jika perangkat dihapus, driver tidak diperlukan untuk mengembalikan D3DDDIERR_DEVICEREMOVED; namun, jika penghapusan perangkat mengganggu pengoperasian AssignDebugBinary (yang biasanya tidak boleh terjadi), driver dapat kembali D3DDDIERR_DEVICEREMOVED.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Target Platform	Desktop
Header	d3d10umddi.h (termasuk D3d10umddi.h)

Lihat juga

D3D11_1DDI_D3D11_OPTIONS_DATA

pfnSetErrorCb

Bagikan melalui