Fungsi DdGetDC (ddrawgdi.h)

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

Pembungkus untuk fungsi NtGdiDdGetDC dan mengembalikan konteks perangkat Windows Graphics Device Interface (GDI) (DC) yang mewakili permukaan Microsoft DirectDraw yang ditunjukkan.

GdiEntry7 didefinisikan sebagai alias untuk fungsi ini.

Sintaks

HDC DdGetDC(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  LPPALETTEENTRY            pColorTable
);

Parameter

pSurfaceLocal

Penunjuk ke permukaan DirectDraw tempat DC diminta.

pColorTable

Penunjuk opsional ke array 256 entri struktur PALETTEENTRY . Jika tabel warna null, dan mode permukaan dan tampilan keduanya adalah 8 bit per piksel, DC berbagi tabel warna perangkat.

Nilai kembali

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

Keterangan

Jika permukaan dan mode tampilan saat ini dipaletkan pada 8 bit per piksel, DC dapat diberikan properti khusus bahwa tabel warnanya dibagikan oleh tabel warna perangkat tampilan. Aplikasi disarankan untuk memanggil IDirectDrawSurface7::GetDC sebagai gantinya, yang menyediakan fungsionalitas yang sama secara independen dari sistem operasi.

DC yang dikembalikan harus dikosongkan dengan panggilan ke NtGdiDdReleaseDC atau GdiEntry8.

Persyaratan

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

Lihat juga

Dukungan Klien Tingkat Rendah Grafis