TSPI_lineGetAddressCaps (tspi.h)

Artikel
03/03/2024

Fungsi TSPI_lineGetAddressCaps meminta alamat yang ditentukan pada perangkat baris yang ditentukan untuk menentukan kemampuan teleponnya.

Sintaks

LONG TSPIAPI TSPI_lineGetAddressCaps(
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwTSPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

Parameter

dwDeviceID

Perangkat baris yang berisi alamat yang akan dikueri.

dwAddressID

Alamat pada perangkat baris yang diberikan yang kemampuannya akan dikueri. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi. Parameter ini tidak divalidasi oleh TAPI ketika fungsi ini dipanggil.

dwTSPIVersion

Nomor versi SPI Telepon yang akan digunakan. Kata urutan tinggi berisi nomor versi utama; kata urutan rendah berisi nomor versi minor.

dwExtVersion

Nomor versi ekstensi khusus penyedia layanan yang akan digunakan. Angka ini nol jika tidak ada ekstensi khusus perangkat yang akan digunakan. Jika tidak, kata urutan tinggi berisi nomor versi utama; kata urutan rendah berisi nomor versi minor. Parameter ini tidak divalidasi oleh TAPI ketika fungsi ini dipanggil.

lpAddressCaps

Penunjuk ke struktur tipe LINEADDRESSCAPS yang bervariasi. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi kemampuan alamat.

Mengembalikan nilai

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

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

Keterangan

Pengidentifikasi perangkat baris yang didukung oleh driver tertentu dinomor secara berurutan dimulai dengan nilai dwLineDeviceIDBase yang diteruskan ke fungsi TSPI_providerInit .

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

Setelah penyedia layanan kembali dari fungsi TSPI_lineGetAddressCaps , TAPI menetapkan anggota dwCallInfoStates dan dwCallStates dari struktur LINEADDRESSCAPS sebagai berikut:

LINEADDRESSCAPS.dwCallInfoStates |=
    LINECALLINFOSTATE_NUMOWNERINCR |
    LINECALLINFOSTATE_NUMOWNERDECR |
    LINECALLINFOSTATE_NUMMONITORS;

LINEADDRESSCAPS.dwCallStates |= LINECALLSTATE_UNKNOWN;

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tspi.h

Lihat juga

LINEADDRESSCAPS

TSPI_providerInit

Bagikan melalui