PDD_DESTROYDDLOCAL fungsi panggilan balik (ddrawint.h)

Artikel
02/29/2024

Fungsi D3dDestroyDDLocal menghancurkan semua permukaan Microsoft Direct3D yang sebelumnya dibuat oleh fungsi D3dCreateSurfaceEx yang termasuk dalam objek Microsoft DirectDraw lokal yang sama.

Sintaks

PDD_DESTROYDDLOCAL PddDestroyddlocal;

DWORD PddDestroyddlocal(
  PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

Menunjuk ke struktur DDHAL_DESTROYDDLOCALDATA yang berisi informasi yang diperlukan pengemudi untuk menghancurkan permukaan.

Nilai kembali

D3dDestroyDDLocal mengembalikan salah satu kode panggilan balik berikut:

Keterangan

Semua driver Direct3D harus mendukung D3dDestroyDDLocal.

Direct3D memanggil D3dDestroyDDLocal ketika aplikasi menunjukkan bahwa konteks Direct3D tidak lagi diperlukan dan akan dihancurkan bersama dengan semua permukaan yang terkait dengannya. Asosiasi datang melalui pointer ke objek DirectDraw lokal. Driver harus membebaskan memori apa pun yang dialokasikan oleh panggilan balik D3dCreateSurfaceEx driver yang dialokasikan untuk setiap permukaan, jika perlu.

Driver tidak boleh menghancurkan permukaan DirectDraw yang terkait dengan permukaan Direct3D ini. Ini adalah tanggung jawab aplikasi.

Penunjuk ke struktur DD_DIRECTDRAW_LOCAL yang diteruskan sebagai anggota lpDDLcl dari struktur D3DHAL_CONTEXTCREATEDATA ketika D3dContextCreate dipanggil dirilis oleh sistem operasi setelah D3dDestroyDDLocal kembali.

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