LPD3DHAL_CONTEXTDESTROYCB fungsi panggilan balik (d3dhal.h)

Artikel
02/26/2024

Fungsi D3dContextDestroy menghapus konteks yang ditentukan.

Sintaks

LPD3DHAL_CONTEXTDESTROYCB Lpd3dhalContextdestroycb;

DWORD Lpd3dhalContextdestroycb(
  LPD3DHAL_CONTEXTDESTROYDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

pcdd [in]

Menunjuk ke struktur D3DHAL_CONTEXTDESTROYDATA yang berisi informasi yang diperlukan driver untuk menghancurkan konteks.

Menampilkan nilai

D3dContextDestroy mengembalikan salah satu kode panggilan balik berikut:

Keterangan

Semua driver Microsoft Direct3D harus mendukung D3dContextDestroy.

Driver harus membebaskan semua sumber daya yang dialokasikan untuk konteks yang sedang dihapus. Misalnya, driver harus membebaskan sumber daya berikut yang terkait dengan konteks:

Sumber daya tekstur
Bayangan puncak dan piksel
Deklarasi dan kode untuk shader vertex
Sumber daya untuk kueri asinkron

Driver tidak boleh membebaskan permukaan Microsoft DirectDraw yang terkait dengan konteks karena ini akan dibebaskan oleh DirectDraw sebagai respons terhadap aplikasi atau permintaan runtime Direct3D.

Jika driver menyimpan penunjuk ke struktur DD_DIRECTDRAW_LOCAL yang diteruskan sebagai anggota lpDDLcl dari struktur D3DHAL_CONTEXTCREATEDATA ketika D3dContextCreate dipanggil, penunjuk mungkin menjadi tidak valid sebelum D3dContextDestroy dipanggil. Oleh karena itu, D3dContextDestroy tidak boleh mendereferensikan penunjuk DD_DIRECTDRAW_LOCAL ini karena pelanggaran akses mungkin mengakibatkan atau data acak mungkin dikembalikan. Misalnya, jika fungsi D3dDestroyDDLocal driver dipanggil sebelum D3dContextDestroy, sistem operasi merilis pointer DD_DIRECTDRAW_LOCAL ini sebelum panggilan D3dContextDestroy .

D3dContextDestroy dapat dipanggil dengan PDEV yang dinonaktifkan. PDEV dinonaktifkan atau diaktifkan dengan memanggil fungsi DrvAssertMode driver tampilan. Lihat Mengelola PDEV untuk informasi selengkapnya.