PDD_SURFCB_DESTROYSURFACE fungsi panggilan balik (ddrawint.h)

Artikel
08/23/2023

Fungsi panggilan balik DdDestroySurface menghancurkan permukaan DirectDraw.

Sintaks

PDD_SURFCB_DESTROYSURFACE PddSurfcbDestroysurface;

DWORD PddSurfcbDestroysurface(
  PDD_DESTROYSURFACEDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

Menunjuk ke struktur DD_DESTROYSURFACEDATA yang berisi informasi yang diperlukan untuk menghancurkan permukaan.

Menampilkan nilai

DdDestroySurface mengembalikan salah satu kode panggilan balik berikut:

Keterangan

Jika DirectDraw melakukan alokasi memori pada waktu pembuatan permukaan dan driver tidak terlibat dalam alokasi, DirectDraw tidak memanggil fungsi DdDestroySurface driver untuk menghancurkan permukaan.

Jika driver melakukan manajemen memori permukaan itu sendiri, DdDestroySurface harus membebaskan memori permukaan dan melakukan pembersihan lainnya, seperti membebaskan data pribadi yang disimpan dalam anggota dwReserved1 dari struktur DD_SURFACE_GLOBAL dan DD_SURFACE_LOCAL .

Untuk permukaan yang dikelola driver, jika permukaan persisten (yaitu, bendera DDSCAPS2_DONOTPERSIST di anggota dwCaps2 struktur DDSCAPS2 untuk permukaan tidak diatur), DdDestroySurface dapat dipanggil dengan tujuan mengeluarkan permukaan dari memori video. Dalam hal ini, driver tampilan dapat terus menyimpan data privat apa pun di anggota dwReserved1 sampai DdDestroySurface dipanggil untuk benar-benar menghancurkan permukaan.

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