Fungsi OpenPort (winsplp.h)

Fungsi OpenPort monitor port membuka port printer.

Sintaksis

BOOL OpenPort(
  LPWSTR  pName,
  PHANDLE pHandle
);

Parameter

pName

Penunjuk yang disediakan penelepon ke string yang berisi nama port yang akan dibuka.

pHandle

Penunjuk yang disediakan penelepon ke lokasi untuk menerima handel port.

Mengembalikan nilai

Jika operasi berhasil, fungsi harus mengembalikan TRUE. Jika tidak, itu harus mengembalikan FALSE.

Komentar

DLL server port monitor diperlukan untuk menentukan fungsi OpenPort dan menyertakan alamat fungsi dalam struktur MONITOR2.

Fungsi OpenPort dipanggil, baik oleh pemantau bahasa atau oleh penampung cetak, ketika antrean cetak sedang tersambung ke port. Tujuan utama fungsi OpenPort adalah mengembalikan handel port yang dapat digunakan pemanggil sebagai argumen input untuk panggilan berikutnya ke StartDocPort, WritePort, ReadPort, EndDocPort, dan fungsi GetPrinterDataFromPort.

Selain mengembalikan handel port, fungsi OpenPort dapat melakukan operasi inisialisasi yang perlu ditangani sebelum operasi baca atau tulis dilakukan. Misalnya, jika port mendukung nilai batas waktu yang dapat dimodifikasi, fungsi OpenPort harus mengatur nilai-nilai ini.

Panggilan ke OpenPort tidak mencetak pekerjaan khusus. Antara setiap panggilan ke OpenPort monitor port dan fungsi ClosePort, mungkin ada beberapa panggilan ke fungsi StartDocPort dan EndDocPort.

Anda dapat berasumsi bahwa setelah penampung cetak memanggil OpenPort dengan nama port tertentu, itu tidak akan memanggil OpenPort lagi dengan nama port yang sama sebelum memanggil ClosePort.

Cetak fungsi monitor yang menerima handel port sebagai input tidak juga menerima handel monitor. Oleh karena itu, fungsi OpenPort harus menyimpan handel monitor yang diterima di lokasi yang dapat dirujuk oleh handel port. Ini memungkinkan fungsi yang menerima handel port untuk mereferensikan handel monitor.

Persyaratan

Syarat	Nilai
Platform Target	Desktop
Header	winsplp.h (termasuk Winsplp.h)
Pustaka	NtosKrnl.exe

Lihat juga

GetPrinterDataFromPort

SetPortTimeOuts

ClosePort

StartDocPort

OpenPortEx

InitializePrintMonitor2

WritePort

EndDocPort

ReadPort