fungsi TSPI_phoneGetDevCaps (tspi.h)

  • Artikel

Fungsi TSPI_phoneGetDevCaps meminta perangkat telepon tertentu untuk menentukan kemampuan teleponnya.

Sintaks

LONG TSPIAPI TSPI_phoneGetDevCaps(
  DWORD       dwDeviceID,
  DWORD       dwTSPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

Parameter

dwDeviceID

Perangkat telepon yang akan dikueri.

dwTSPIVersion

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

dwExtVersion

Nomor versi ekstensi yang dinegosiasikan. Nilai ini dinegosiasikan untuk perangkat ini melalui fungsi TSPI_phoneNegotiateExtVersion .

lpPhoneCaps

Pointer ke memori tempat penyedia layanan menulis struktur jenis PHONECAPS yang bervariasi. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi kemampuan perangkat telepon. Sebelum memanggil TSPI_phoneGetDevCaps, aplikasi mengatur anggota dwTotalSize dari struktur ini untuk menunjukkan jumlah memori yang tersedia untuk TAPI untuk mengembalikan informasi.

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

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

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

Setelah penyedia layanan kembali dari fungsi TSPI_phoneGetDevCaps , TAPI menetapkan anggota dwPhoneStates dari struktur PHONECAPS sebagai berikut:

PHONECAPS.dwPhoneStates |=
    PHONESTATE_OWNER |
    PHONESTATE_MONITORS |
    PHONESTATE_REINIT;

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tspi.h

Lihat juga

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneNegotiateExtVersion