fungsi TSPI_lineNegotiateTSPIVersion (tspi.h)

Artikel
03/13/2024

Fungsi TSPI_lineNegotiateTSPIVersion mengembalikan versi SPI tertinggi yang dapat dioperasikan penyedia layanan untuk perangkat ini, mengingat rentang kemungkinan versi SPI.

Sintaks

LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
  DWORD   dwDeviceID,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwTSPIVersion
);

Parameter

dwDeviceID

Mengidentifikasi perangkat baris tempat negosiasi versi antarmuka akan dilakukan. Selain pengidentifikasi perangkat dalam rentang yang didukung penyedia layanan, ini mungkin nilainya:

INITIALIZE_NEGOTIATION

Nilai ini digunakan untuk menandakan bahwa versi antarmuka keseluruhan akan dinegosiasikan.

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. 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 LINEERR_INCOMPATIBLEAPIVERSION.

Nilai kembali

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Keterangan

Ketika dwDeviceIDINITIALIZE_NEGOTIATION, fungsi ini tidak boleh mengembalikan LINEERR_OPERATIONUNAVAIL, karena fungsi ini (dengan nilai tersebut) wajib untuk menegosiasikan versi antarmuka keseluruhan meskipun penyedia layanan tidak mendukung perangkat baris.