Fungsi EngCreateDeviceSurface (winddi.h)

Fungsi EngCreateDeviceSurface membuat dan mengembalikan handel untuk permukaan perangkat yang akan dikelola driver.

Sintaks

ENGAPI HSURF EngCreateDeviceSurface(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

Parameter

[in] dhsurf

Handel perangkat ke permukaan yang akan dikelola oleh perangkat. Handel ini diteruskan ke driver ketika struktur SURFOBJ diteruskan untuk input atau output.

[in] sizl

Menentukan struktur SIZEL yang berisi lebar dan tinggi permukaan yang akan dibuat. Anggota cx dan cy dari struktur ini masing-masing berisi, lebar dan tinggi permukaan, dalam piksel. Struktur SIZEL identik dengan struktur SIZE .

iFormatCompat

Menentukan format mesin yang kompatibel dari permukaan perangkat yang sedang dibuat. Ini digunakan oleh GDI jika buffer sementara diperlukan untuk mensimulasikan panggilan gambar yang rumit.

Nilai kembali

Nilai yang dikembalikan adalah handel yang mengidentifikasi permukaan jika fungsi berhasil. Jika tidak, itu adalah nol, dan kode kesalahan dicatat.

Keterangan

Ruang penyimpanan untuk permukaan dapat secara opsional disediakan oleh driver. Permukaan harus dikaitkan dengan menggunakan EngAssociateSurface. Permukaan harus dihapus ketika tidak lagi diperlukan dengan menggunakan EngDeleteSurface.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	winddi.h (termasuk Winddi.h)
Pustaka	Win32k.lib
DLL	Win32k.sys

Lihat juga

EngAssociateSurface

EngDeleteSurface

SURFOBJ