Fungsi DrvDisableSurface (winddi.h)

Artikel
08/27/2023

Fungsi DrvDisableSurface digunakan oleh GDI untuk memberi tahu driver bahwa permukaan yang dibuat oleh DrvEnableSurface untuk perangkat saat ini tidak lagi diperlukan.

Sintaks

void DrvDisableSurface(
  DHPDEV dhpdev
);

Parameter

dhpdev

Tangani ke PDEV perangkat fisik. Ini adalah handel ke perangkat yang permukaannya akan dilepaskan.

Menampilkan nilai

Tidak ada

Keterangan

Driver harus membebaskan memori dan sumber daya apa pun yang digunakan oleh permukaan yang terkait dengan PDEV segera setelah perangkat fisik dinonaktifkan.

Jika driver telah dinonaktifkan oleh panggilan ke DrvAssertMode, driver tidak boleh mengakses perangkat keras selama DrvDisableSurface karena PDEV aktif lain mungkin sedang digunakan. Setiap perubahan perangkat keras yang diperlukan harus dilakukan selama panggilan ke DrvAssertMode. Driver harus melacak apakah telah dinonaktifkan oleh DrvAssertMode sehingga dapat melakukan operasi pembersihan yang tepat di DrvDisableSurface.

Jika perangkat fisik memiliki permukaan yang diaktifkan, GDI memanggil DrvDisableSurface sebelum memanggil DrvDisablePDEV.

DrvDisableSurface diperlukan untuk driver grafis.