Fungsi NtGdiDdLock

  • Artikel

[Fungsi ini dapat berubah dengan setiap revisi sistem operasi. Sebagai gantinya, gunakan Microsoft 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.]

Mengunci area memori permukaan tertentu dan menyediakan penunjuk yang valid ke blok memori yang terkait dengan permukaan.

Sintaks

DWORD APIENTRY NtGdiDdLock(
  _In_    HANDLE       hSurface,
  _Inout_ PDD_LOCKDATA puLockData,
  _In_    HDC          hdcClip
);

Parameter

hSurface [in]

Tangani ke struktur DD_SURFACE_LOCAL yang menjelaskan permukaan yang terkait dengan wilayah memori yang akan dikunci.

puLockData [masuk, keluar]

Penunjuk ke struktur DD_LOCKDATA yang berisi informasi yang diperlukan untuk melakukan penguncian.

hdcClip [in]

Dicadangkan.

Nilai kembali

NtGdiDdLock 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 menjalankan implementasi independen perangkat DirectDraw atau Direct3D.

 

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