fungsi TSPI_lineClose (tspi.h)

Fungsi TSPI_lineClose menutup perangkat open line yang ditentukan setelah menyelesaikan atau membatalkan semua panggilan yang luar biasa dan operasi asinkron pada perangkat.

Sintaks

LONG TSPIAPI TSPI_lineClose(
  HDRVLINE hdLine
);

Parameter

hdLine

Handel penyedia layanan ke baris yang akan ditutup. Setelah baris berhasil ditutup, handel ini tidak lagi valid.

Nilai kembali

Mengembalikan nol jika fungsi berhasil atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.

Keterangan

Penyedia layanan harus melaporkan penyelesaian untuk setiap operasi asinkron. Jika TSPI_lineClose dipanggil untuk baris di mana ada operasi asinkron yang luar biasa, operasi dilaporkan lengkap dengan hasil atau kode kesalahan yang sesuai sebelum prosedur ini kembali.

Persyaratan serupa ada untuk panggilan aktif di telepon. Operasi yang luar biasa harus dilaporkan lengkap dengan hasil atau kode kesalahan yang sesuai. Panggilan aktif juga harus dihilangkan, jika diperlukan, dan jika perilaku ini ditunjukkan oleh bit LINEDEVCAPFLAGS_CLOSEDROP dalam struktur LINEDEVCAPS .

Setelah prosedur ini kembali, penyedia layanan harus melaporkan tidak ada htCall lebih lanjut pada baris atau panggilan yang ada di saluran. Handel penyedia layanan untuk baris dan panggilan pada baris menjadi "tidak valid."

Penyedia layanan harus melepaskan sumber daya yang tidak dapat dibagikan yang dicadangkannya saat jalur terbuka. Misalnya, menutup garis yang diakses melalui port comm dan modem akan mengakibatkan penutupan port comm, membuatnya sekali lagi tersedia untuk digunakan oleh aplikasi lain.

Penyedia layanan tidak mengeluarkan pesan LINE_LINEDEVSTATE sebagai respons terhadap pemanggilan fungsi ini karena baris ditutup dan tidak ada lagi minat pada perubahan statusnya.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tspi.h

Lihat juga

LINEDEVCAPS

LINE_CLOSE

LINE_LINEDEVSTATE