PFND3D11DDI_DESTROYCOMMANDLIST fungsi panggilan balik (d3d10umddi.h)

Fungsi DestroyCommandList menghancurkan daftar perintah.

Sintaks

PFND3D11DDI_DESTROYCOMMANDLIST Pfnd3d11ddiDestroycommandlist;

void Pfnd3d11ddiDestroycommandlist(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D11DDI_HCOMMANDLIST unnamedParam2
)
{...}

Parameter

unnamedParam1

hDevice [in]

Handel ke perangkat tampilan (konteks grafis).

unnamedParam2

hCommandList [in]

Handel ke data pribadi driver agar daftar perintah dihancurkan. Runtime Microsoft Direct3D membebaskan wilayah memori yang sebelumnya dialokasikan untuk daftar perintah. Oleh karena itu, driver tidak dapat lagi mengakses wilayah memori ini.

Menampilkan nilai

Tidak ada

Keterangan

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

Driver hanya diperlukan untuk menerapkan DestroyCommandList jika driver mendukung kemampuan D3D11DDICAPS_COMMANDLISTS_BUILD_2 yang dapat dikembalikan dalam struktur D3D11DDI_THREADING_CAPS dari panggilan ke fungsi GetCaps(D3D10_2).

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

Driver dapat menerapkan fungsi DestroyCommandList yang berisi pernyataan switch untuk memproses penghancuran daftar perintah dan penghancuran ringan daftar perintah. Artinya, driver dapat mengimplementasikan satu DestroyCommandList, dan dapat mengatur anggota pfnRecycleDestroyCommandList dari struktur D3D11DDI_DEVICEFUNCS untuk menunjuk ke DestroyCommandList bersama dengan anggota pfnRecycleDestroyCommandList dari D3D11DDI_DEVICEFUNCS untuk menunjuk ke DestroyCommandList. Namun, untuk meningkatkan performa, driver dapat menerapkan fungsi DestroyCommandList dan RecycleDestroyCommandList terpisah.

Untuk informasi selengkapnya tentang RecycleDestroyCommandList, lihat Pengoptimalan untuk Lists Perintah Kecil.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	DestroyCommandList didukung dimulai dengan sistem operasi Windows 7.
Target Platform	Desktop
Header	d3d10umddi.h (termasuk D3d10umddi.h)

Lihat juga

CreateCommandList

D3D11DDI_DEVICEFUNCS

D3D11DDI_THREADING_CAPS

GetCaps(D3D10_2)

pfnSetErrorCb