fungsi TSPI_lineGetDevCaps (tspi.h)

  • Artikel

Fungsi TSPI_lineGetDevCaps meminta perangkat baris tertentu untuk menentukan kemampuan teleponnya. Informasi yang dikembalikan valid untuk semua alamat pada perangkat baris.

Sintaks

LONG TSPIAPI TSPI_lineGetDevCaps(
  DWORD         dwDeviceID,
  DWORD         dwTSPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Parameter

dwDeviceID

Perangkat baris yang akan dikueri.

dwTSPIVersion

Nomor versi TSPI yang dinegosiasikan. Nilai ini telah dinegosiasikan untuk perangkat ini melalui fungsi TSPI_lineNegotiateTSPIVersion .

dwExtVersion

Nomor versi ekstensi yang dinegosiasikan. Nilai ini telah dinegosiasikan untuk perangkat ini melalui fungsi TSPI_lineNegotiateExtVersion . Parameter ini tidak divalidasi oleh TAPI ketika fungsi ini dipanggil.

lpLineDevCaps

Penunjuk ke struktur berukuran bervariasi dari jenis LINEDEVCAPS. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi kemampuan perangkat baris.

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_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Keterangan

Penomoran pengidentifikasi perangkat baris untuk penyedia layanan berurutan dari nilai yang ditetapkan oleh parameter dwLineDeviceIDBase yang diteruskan ke fungsi TSPI_providerInit .

Parameter formal dwExtVersion menunjukkan nomor versi informasi ekstensi yang diminta. Jika nol, tidak ada informasi ekstensi yang diminta. Jika bukan nol, ia memegang nilai yang dinegosiasikan untuk perangkat ini dengan fungsi TSPI_lineNegotiateExtVersion . Penyedia layanan mengisi informasi yang diperluas khusus perangkat dan vendor sesuai dengan versi ekstensi yang ditentukan.

Penyedia layanan mengisi semua anggota struktur data LINEDEVCAPS , kecuali dwTotalSize, yang diisi oleh TAPI. Penyedia layanan tidak boleh menimpa anggota dwTotalSize .

Penyedia layanan harus mengisi semua anggota struktur atau struktur data LINETERMCAPS yang disematkan di berbagai bagian struktur data LINEDEVCAPS .

Setelah penyedia layanan kembali dari fungsi TSPI_lineGetDevCaps , TAPI menetapkan anggota dwLinesStates dari struktur LINEDEVCAPS sebagai berikut:

LINEDEVCAPS.dwLineStates |=
    LINEDEVSTATE_OPEN |
    LINEDEVSTATE_CLOSE |
    LINEDEVSTATE_REINIT |
    LINEDEVSTATE_TRANSLATECHANGE;

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tspi.h

Lihat juga

LINEDEVCAPS

LINETERMCAPS

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion

TSPI_providerInit