Fungsi NtGdiDdGetDC

Artikel
06/13/2023

[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.]

Membuat konteks perangkat (DC) untuk permukaan yang ditentukan.

Sintaks

HDC APIENTRY NtGdiDdGetDC(
  _In_ HANDLE       hSurface,
  _In_ PALETTEENTRY *puColorTable
);

Parameter

hSurface [in]: Tangani ke permukaan DirectDraw mode kernel yang sebelumnya dikembalikan oleh NtGdiDdCreateSurface atau NtGdiDdCreateSurfaceObject.
puColorTable [in]: Penunjuk ke tabel warna penimpaan untuk DC yang dikembalikan.

Nilai kembali

Jika berhasil, fungsi ini mengembalikan HDC yang valid; jika tidak, ia mengembalikan NULL.

Keterangan

Hanya satu DC yang diizinkan per permukaan pada waktu tertentu. Panggilan berikutnya ke NtGdiDdGetDC akan gagal hingga DC sebelumnya dirilis.

Aplikasi disarankan untuk memanggil IDirectDrawSurface7::GetDC sebagai gantinya, yang menyediakan fungsionalitas yang sama secara independen dari sistem operasi.

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
DdGetDC

Share via