Fungsi CreateICA (wingdi.h)

Artikel
08/27/2023

Fungsi CreateIC membuat konteks informasi untuk perangkat yang ditentukan. Konteks informasi menyediakan cara cepat untuk mendapatkan informasi tentang perangkat tanpa membuat konteks perangkat (DC). Namun, fungsi gambar GDI tidak dapat menerima handel ke konteks informasi.

Sintaks

HDC CreateICA(
  [in] LPCSTR         pszDriver,
  [in] LPCSTR         pszDevice,
       LPCSTR         pszPort,
  [in] const DEVMODEA *pdm
);

Parameter

[in] pszDriver

Penunjuk ke string karakter yang dihentikan null yang menentukan nama driver perangkat (misalnya, Epson).

[in] pszDevice

Penunjuk ke string karakter yang dihentikan null yang menentukan nama perangkat output tertentu yang digunakan, seperti yang ditunjukkan oleh Print Manager (misalnya, Epson FX-80). Ini bukan nama model printer. Parameter lpszDevice harus digunakan.

pszPort

Parameter ini diabaikan dan harus diatur ke NULL. Ini disediakan hanya untuk kompatibilitas dengan Windows 16-bit.

[in] pdm

Penunjuk ke struktur DEVMODE yang berisi data inisialisasi khusus perangkat untuk driver perangkat. Fungsi DocumentProperties mengambil struktur ini yang diisi untuk perangkat tertentu. Parameter lpdvmInit harus NULL jika driver perangkat menggunakan inisialisasi default (jika ada) yang ditentukan oleh pengguna.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke konteks informasi.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Saat Anda tidak lagi memerlukan informasi DC, panggil fungsi DeleteDC .

Catatan

Header wingdi.h mendefinisikan CreateIC sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll