Fungsi CreateICW (wingdi.h)

Artikel
11/20/2024

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.

Sintaksis

HDC CreateICW(
  [in] LPCWSTR        pszDriver,
  [in] LPCWSTR        pszDevice,
       LPCWSTR        pszPort,
  [in] const DEVMODEW *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 hanya disediakan 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.

Mengembalikan nilai

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

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Komentar

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

Nota

Header wingdi.h mendefinisikan CreateIC sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wingdi.h (termasuk Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Lihat juga

DEVMODE

DeleteDC

Fungsi Konteks Perangkat

Gambaran Umum Konteks Perangkat

DocumentProperties

GetDeviceCaps

Bagikan melalui