fungsi TSPI_phoneNegotiateExtVersion (tspi.h)

Fungsi TSPI_phoneNegotiateExtVersion mengembalikan nomor versi ekstensi tertinggi yang dapat dioperasikan penyedia layanan untuk perangkat ini, mengingat rentang kemungkinan versi ekstensi.

Sintaks

LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

Parameter

dwDeviceID

Mengidentifikasi perangkat telepon tempat negosiasi versi antarmuka akan dilakukan.

dwTSPIVersion

Menentukan nomor versi antarmuka yang dinegosiasikan untuk perangkat ini menggunakan TSPI_phoneNegotiateTSPIVersion. Fungsi ini beroperasi sesuai dengan spesifikasi antarmuka pada tingkat versi ini.

dwLowVersion

Nomor versi ekstensi terendah di mana TAPI atau aplikasi kliennya dapat beroperasi. WORD yang paling signifikan adalah nomor versi utama dan WORD yang paling tidak signifikan adalah nomor versi minor.

dwHighVersion

Nomor versi ekstensi tertinggi di mana TAPI atau aplikasi kliennya dapat beroperasi. WORD yang paling signifikan adalah nomor versi utama dan WORD yang paling tidak signifikan adalah nomor versi minor.

lpdwExtVersion

Penunjuk ke DWORD. Setelah berhasil kembali dari fungsi ini, penyedia layanan mengisi lokasi ini dengan nomor versi ekstensi 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_INCOMPATIBLEEXTVERSION.

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_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.

Keterangan

Fungsi ini dapat dipanggil sebelum atau sesudah perangkat dibuka oleh TAPI. Jika perangkat saat ini terbuka dan memiliki versi ekstensi yang dipilih, fungsi harus mengembalikan nomor versi tersebut jika berada dalam rentang yang diminta. Jika nomor versi yang dipilih berada di luar rentang yang diminta, fungsi akan mengembalikan PHONEERR_INCOMPATIBLEEXTVERSION.

Persyaratan

Target Platform	Windows
Header	tspi.h

Lihat juga

TSPI_phoneNegotiateTSPIVersion