fungsi 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 tempat negosiasi versi antarmuka 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 akan mengembalikan PHONEERR_INCOMPATIBLEAPIVERSION.

Nilai kembali

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

Lihat juga

INITIALIZE_NEGOTIATION

TSPI_phoneGetExtensionID

TSPI_phoneNegotiateExtVersion