Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 |