fungsi TSPI_lineGetDevCaps (tspi.h)
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 |