TSPI_phoneNegotiateTSPIVersion (tspi.h)
Fungsi TSPI_phoneNegotiateTSPIVersion mengembalikan versi SPI tertinggi yang dapat dioperasikan penyedia layanan untuk perangkat ini, mengingat rentang kemungkinan versi SPI.
Sintaks
LONG TSPIAPI TSPI_phoneNegotiateTSPIVersion(
DWORD dwDeviceID,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwTSPIVersion
);
Parameter
dwDeviceID
Perangkat telepon yang negosiasi versi antarmukanya akan dilakukan. Nilai yang diizinkan benar-benar dalam rentang pengidentifikasi perangkat telepon untuk penyedia layanan ini; nilai INITIALIZE_NEGOTIATION tidak pernah diteruskan ke fungsi ini.
dwLowVersion
Nomor versi TSPI terendah di mana TAPI dapat beroperasi. WORD yang paling signifikan adalah nomor versi utama dan WORD yang paling tidak signifikan adalah nomor versi minor.
dwHighVersion
Nomor versi TSPI tertinggi di mana TAPI dapat beroperasi. WORD yang paling signifikan adalah nomor versi utama dan WORD yang paling tidak signifikan adalah nomor versi minor.
lpdwTSPIVersion
Penunjuk ke DWORD. Setelah berhasil kembali dari fungsi ini, penyedia layanan mengisi lokasi ini dengan nomor versi TSPI tertinggi, dalam rentang yang diminta oleh pemanggil, di mana penyedia layanan dapat beroperasi. WORD yang paling signifikan adalah nomor versi utama dan WORD yang paling tidak signifikan adalah nomor versi minor. Jika rentang yang diminta tidak tumpang tindih dengan rentang yang didukung oleh penyedia layanan, fungsi mengembalikan PHONEERR_INCOMPATIBLEAPIVERSION.
Mengembalikan nilai
Mengembalikan nol jika fungsi berhasil, atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Keterangan
Penyedia layanan mengembalikan PHONEERR_OPERATIONUNAVAIL jika operasi tidak tersedia. Namun, jika penyedia layanan mendukung perangkat telepon apa pun, ia juga harus mendukung fungsi ini dan fungsi tidak boleh mengembalikan PHONEERR_OPERATIONUNAVAIL.
TAPI memanggil fungsi ini lebih awal dalam urutan inisialisasi untuk setiap perangkat telepon.
Negosiasi versi ekstensi dilakukan melalui prosedur terpisah TSPI_phoneNegotiateExtVersion.
Fungsi yang sesuai di tingkat TAPI adalah fungsi kelebihan beban yang juga mengambil pengidentifikasi ekstensi, jika ada, didukung oleh penyedia layanan. Pada tingkat TSPI, pengambilan pengidentifikasi ekstensi dilakukan melalui prosedur terpisah, yaitu, TSPI_phoneGetExtensionID.
Persyaratan
| Target Platform | Windows |
| Header | tspi.h |