fungsi TSPI_lineSelectExtVersion (tspi.h)

  • Artikel

Fungsi TSPI_lineSelectExtVersion memilih versi ekstensi yang ditunjukkan untuk perangkat baris yang ditunjukkan. Permintaan berikutnya beroperasi sesuai dengan versi ekstensi tersebut.

Sintaks

LONG TSPIAPI TSPI_lineSelectExtVersion(
  HDRVLINE hdLine,
  DWORD    dwExtVersion
);

Parameter

hdLine

Handel ke baris yang versi ekstensinya akan dipilih.

dwExtVersion

Versi ekstensi yang akan dipilih. Nomor versi ini telah dinegosiasikan menggunakan TSPI_lineNegotiateExtVersion. WORD yang paling signifikan adalah nomor versi utama dan WORD yang paling tidak signifikan adalah nomor versi minor. Memanggil fungsi ini dengan dwExtVersion nol membatalkan pilihan saat ini.

Nilai kembali

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

LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.

Keterangan

Penyedia layanan memilih versi ekstensi yang ditunjukkan. Meskipun nomor versi yang ditunjukkan mungkin telah berhasil dinegosiasikan, versi ekstensi yang berbeda mungkin telah dipilih sementara, dalam hal ini fungsi ini gagal (mengembalikan LINEERR_INCOMPATIBLEEXTVERSION).

Operasi berikutnya pada baris setelah versi ekstensi dipilih berperilaku sesuai dengan versi ekstensi tersebut. Upaya berikutnya untuk menegosiasikan laporan versi ekstensi dengan ketat versi yang dipilih atau 0 (jika rentang yang diminta tidak menyertakan versi yang dipilih). Memanggil prosedur ini dengan ekstensi khusus versi 0 membatalkan pilihan saat ini. Perangkat menjadi sekali lagi yang mampu mendukung berbagai nomor versi ekstensinya.

Fungsi ini tidak memiliki korespondensi langsung di tingkat TAPI, di mana memilih versi ekstensi dibundel dengan fungsionalitas lineOpen lainnya. Fungsi TSPI_lineSelectExtVersion biasanya dipanggil dalam dua situasi: (1) Aplikasi yang diminta untuk membuka baris, perubahan pemantauan jenis media yang dihasilkan berhasil, aplikasi meminta agar versi ekstensi tertentu digunakan, dan tidak ada versi ekstensi yang saat ini dipilih. (2) Aplikasi terakhir yang menggunakan versi ekstensi tertentu menutup baris, dan pilihan versi ekstensi dapat dibatalkan.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tspi.h

Lihat juga

TSPI_lineNegotiateExtVersion