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.
Layanan faks memanggil fungsi FaxDevStartJob untuk menginisialisasi pekerjaan faks baru. Layanan faks juga memanggil FaxDevStartJob untuk memberi sinyal awal setiap operasi faks ke penyedia layanan faks (FSP). Setiap FSP harus mengekspor fungsi FaxDevStartJob .
Sintaks
BOOL FaxDevStartJob(
[in] HLINE LineHandle,
[in] DWORD DeviceId,
[out] PHANDLE FaxHandle,
[in] HANDLE CompletionPortHandle,
[in] ULONG_PTR CompletionKey
);
Parameter
[in] LineHandle
Jenis: HLINE
Menentukan handel ke perangkat baris terbuka yang terkait dengan pekerjaan faks.
[in] DeviceId
Jenis: DWORD
Menentukan pengidentifikasi perangkat baris TAPI yang terkait dengan pekerjaan faks.
[out] FaxHandle
Jenis: PHANDLE
Penunjuk ke variabel yang menerima handel faks yang terkait dengan pekerjaan faks. FSP harus mengatur handel ini ke nilai yang bermakna; handel ini biasanya menentukan pointer ke blok memori dengan data instans khusus pekerjaan.
[in] CompletionPortHandle
Jenis: HANDEL
Menentukan handel ke port penyelesaian I/O. Untuk informasi selengkapnya, lihat Port Penyelesaian I/O.
[in] CompletionKey
Jenis: ULONG_PTR
Menentukan nilai kunci penyelesaian. Penyedia layanan faks harus meneruskan nilai buram ini ke fungsi PostQueuedCompletionStatus .
Mengembalikan nilai
Jenis: BOOL
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, layanan faks memanggil GetLastError.
Keterangan
Fungsi FaxDevStartJob memberikan kesempatan bagi penyedia layanan faks untuk melakukan penyiapan panggilan.
Layanan faks memanggil FaxDevStartJob di awal pekerjaan faks baru dan sekali untuk setiap operasi faks. Ini karena setiap operasi dijalankan dalam utas terpisah. Ini memanggil FaxDevStartJob tepat sebelum fungsi FaxDevSend memanggil operasi pengiriman faks, dan tepat sebelum fungsi FaxDevReceive memanggil operasi penerima faks. Untuk informasi selengkapnya, lihat Beroperasi di Lingkungan Multithreaded.
FSP harus membuat paket penyelesaian I/O dan memanggil fungsi PostQueuedCompletionStatus saat FSP mengubah statusnya. Salah satu contoh perubahan status adalah ketika FSP selesai menerima atau mengirim halaman transmisi faks. Paket penyelesaian harus merupakan struktur FAX_DEV_STATUS . FSP harus mengalokasikan memori untuk struktur dari timbunan yang ditunjukkan oleh parameter HeapHandle yang diteruskan ke fungsi FaxDevInitialize . Penyedia layanan faks harus meneruskan ukuran memori yang dialokasikan ke parameter dwNumberOfBytesTransferred dari metode PostQueuedCompletionStatus. Layanan faks membebaskan memori apa pun yang dialokasikan untuk struktur paket penyelesaian.
FSP harus menggunakan parameter CompletionPortHandle dan CompletionKey untuk pasca penyelesaian paket untuk perubahan status FSP. Metode pemberitahuan status ini mengoptimalkan performa karena layanan faks tidak perlu melakukan polling FSP untuk mendapatkan informasi status yang diperbarui. Untuk informasi selengkapnya, lihat Membuat Paket Penyelesaian.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional, Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | faxdev.h |