Fungsi NtGdiDdDestroySurface

Artikel
06/12/2023

[Fungsi ini dapat berubah dengan setiap revisi sistem operasi. Sebagai gantinya, gunakan DirectDraw dan Microsoft Direct3DAPIs; API ini mengisolasi aplikasi dari perubahan sistem operasi tersebut, dan menyembunyikan banyak kesulitan lain yang terlibat dalam berinteraksi langsung dengan pengandar tampilan.]

Menghancurkan objek permukaan Microsoft DirectDraw mode kernel yang dialokasikan sebelumnya.

Sintaks

DWORD APIENTRY NtGdiDdDestroySurface(
  _In_ HANDLE hSurface,
  _In_ BOOL   bRealDestroy
);

Parameter

hSurface [in]: Tangani ke objek permukaan mode kernel yang dialokasikan sebelumnya.
bRealDestroy [in]: Menentukan cara menghancurkan permukaan. Bisa menjadi salah satu nilai berikut.
(BENAR): Hancurkan permukaan dan memori video gratis.
(FALSE): Bebaskan memori video tetapi biarkan permukaan dalam keadaan tidak diinisialisasi.

Menampilkan nilai

NtGdiDdDestroySurface mengembalikan salah satu kode panggilan balik berikut.

Menampilkan kode	Deskripsi
DDHAL_DRIVER_HANDLED	Driver telah melakukan operasi dan mengembalikan kode pengembalian yang valid untuk operasi tersebut. Jika kode ini DD_OK, DirectDraw atau Direct3D melanjutkan fungsi. Jika tidak, DirectDraw atau Direct3D mengembalikan kode kesalahan yang disediakan oleh driver dan membatalkan fungsi.
DDHAL_DRIVER_NOTHANDLED	Driver tidak memiliki komentar tentang operasi yang diminta. Jika driver diharuskan menerapkan panggilan balik tertentu, DirectDraw atau Direct3D melaporkan kondisi kesalahan. Jika tidak, DirectDraw atau Direct3D menangani operasi seolah-olah panggilan balik driver belum ditentukan dengan mengeksekusi implementasi independen perangkat DirectDraw atau Direct3D.

Keterangan

Disarankan agar aplikasi menggunakan API DirectDraw dan Direct3D untuk membuat dan menghancurkan permukaan alih-alih fungsi ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Ntgdi.h

Lihat juga

Dukungan Klien Tingkat Rendah Grafis

Bagikan melalui