Fungsi EngAssociateSurface (winddi.h)

Artikel
08/27/2023

Fungsi EngAssociateSurface menandai permukaan tertentu sebagai milik perangkat tertentu.

Sintaks

ENGAPI BOOL EngAssociateSurface(
  HSURF hsurf,
  HDEV  hdev,
  FLONG flHooks
);

Parameter

hsurf

Tangani ke permukaan atau bitmap yang akan dikaitkan dengan hdev. Handel ini dikembalikan oleh EngCreateBitmap atau EngCreateDeviceBitmap.

hdev

Tangani ke perangkat yang permukaannya akan dikaitkan. Ini adalah handel yang dibuat GDI yang diteruskan ke fungsi DrvCompletePDEV driver.

flHooks

Menentukan fungsi yang dapat dikaitkan oleh driver dari GDI. Driver harus menerapkan fungsi yang sesuai untuk setiap bit yang ditetapkannya dalam flHooks. Anggota ini adalah bitwise ATAU dari salah satu nilai berikut:

Bendera	Fungsi yang akan dikaitkan
HOOK_ALPHABLEND	DrvAlphaBlend
HOOK_BITBLT	DrvBitBlt
HOOK_COPYBITS	DrvCopyBits
HOOK_FILLPATH	DrvFillPath
HOOK_GRADIENTFILL	DrvGradientFill
HOOK_LINETO	DrvLineTo
HOOK_MOVEPANNING	Kedaluwarsa
HOOK_PAINT	Kedaluwarsa
HOOK_PLGBLT	DrvPlgBlt
HOOK_STRETCHBLT	DrvStretchBlt
HOOK_STRETCHBLTROP	DrvStretchBltROP
HOOK_STROKEANDFILLPATH	DrvStrokeAndFillPath
HOOK_STROKEPATH	DrvStrokePath
HOOK_SYNCHRONIZE	DrvSynchronize atau DrvSynchronizeSurface (baik atau keduanya)
HOOK_SYNCHRONIZEACCESS	Kedaluwarsa
HOOK_TEXTOUT	DrvTextOut
HOOK_TRANSPARENTBLT	DrvTransparentBlt

Mengembalikan nilai

Nilai yang dikembalikan adalah TRUE jika fungsi berhasil. Jika tidak, driver harus mengirim informasi ke fungsi GDI yang diimplementasikannya, dan mengembalikan nilai pengembalian GDI.

Keterangan

EngAssociateSurface dapat digunakan oleh driver printer untuk menerapkan "aturan" atau font perangkat, atau dengan driver tampilan untuk menggunakan perangkat keras blt khusus.

Jika permukaan yang diidentifikasi oleh hsurf adalah bitmap format standar, driver dapat menentukan fungsi output mana ke permukaan yang akan ditanganinya dengan mengatur bit di flHooks. Mengatur bit dalam flHooks menyebabkan fungsi output tertentu dikirim ke driver sebagai gantinya. Ini disebut sebagai kait. Jika driver tidak menghubungkan panggilan, GDI akan secara otomatis mengelola operasi ketika bitmap format standar sedang ditarik.

Ketika permukaan dikaitkan, ia mengasumsikan palet default dan langkah-langkah gaya PDEV. Permukaan harus dikaitkan sebelum dikembalikan oleh DrvEnableSurface.

Secara default, ketika driver mendukung bitmap perangkat dengan menerapkan DrvCreateDeviceBitmap/DrvDeleteDeviceBitmap, GDI tidak secara otomatis menyinkronkan panggilan gambar ke bitmap perangkat dan ke permukaan utama. Misalnya, GDI dapat memanggil fungsi DrvBitBlt driver untuk menggambar ke bitmap perangkat, sementara utas lain menggambar ke permukaan utama dengan mengeksekusi implementasi driver DrvTextOut. Driver bahkan dapat dipanggil untuk menggambar ke beberapa bitmap perangkat secara bersamaan.

Setelah DrvEnableSurface mengembalikan handel ke permukaan utama, jangan panggil EngAssociateSurface pada handel tersebut. Melakukannya dapat menyebabkan pemeriksaan bug dalam keadaan tertentu. Untuk informasi selengkapnya, lihat artikel Microsoft Knowledge Base 330248.

Persyaratan


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