Fungsi escape (wingdi.h)

Artikel
08/27/2023

Fungsi Escape memungkinkan aplikasi untuk mengakses kemampuan perangkat yang ditentukan sistem yang tidak tersedia melalui GDI. Panggilan escape yang dilakukan oleh aplikasi diterjemahkan dan dikirim ke driver.

Sintaks

int Escape(
  [in]  HDC    hdc,
  [in]  int    iEscape,
  [in]  int    cjIn,
  [in]  LPCSTR pvIn,
  [out] LPVOID pvOut
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] iEscape

Fungsi escape yang akan dilakukan. Parameter ini harus menjadi salah satu nilai escape yang telah ditentukan sebelumnya yang tercantum dalam Remarks. Gunakan fungsi ExtEscape jika aplikasi Anda menentukan nilai escape privat.

[in] cjIn

Jumlah byte data yang diacu oleh parameter lpvInData . Ini bisa 0.

[in] pvIn

Penunjuk ke struktur input yang diperlukan untuk escape yang ditentukan.

[out] pvOut

Pointer ke struktur yang menerima output dari escape ini. Parameter ini harus NULL jika tidak ada data yang dikembalikan.

Nilai kembali

Jika fungsi berhasil, nilai pengembalian lebih besar dari nol, kecuali dengan escape printer QUERYESCSUPPORT , yang hanya memeriksa implementasi. Jika escape tidak diimplementasikan, nilai yang dikembalikan adalah nol.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem.

Keterangan

Catatan Ini adalah fungsi pemblokiran atau sinkron dan mungkin tidak segera kembali. Seberapa cepat fungsi ini kembali tergantung pada faktor run-time seperti status jaringan, konfigurasi server cetak, dan implementasi driver printer—faktor-faktor yang sulit diprediksi saat menulis aplikasi. Memanggil fungsi ini dari utas yang mengelola interaksi dengan antarmuka pengguna dapat membuat aplikasi tampak tidak responsif.

Efek passing 0 untuk cbInput akan tergantung pada nilai nEscape dan pada driver yang menangani escape.

Dari pelarian printer asli, hanya berikut ini yang dapat digunakan.

Escape	Deskripsi
QUERYESCSUPPORT	Menentukan apakah escape tertentu diimplementasikan oleh driver perangkat.
PASSTHROUGH	Memungkinkan aplikasi mengirim data langsung ke printer.

Untuk informasi tentang escape printer, lihat ExtEscape.

Gunakan fungsi StartPage untuk menyiapkan driver printer untuk menerima data.

Persyaratan


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