fungsi TSPI_lineSetCallQualityOfService (tspi.h)

  • Artikel

Penyedia layanan fungsi TSPI_lineSetCallQualityOfService mencoba untuk menegosiasikan ulang QOS pada panggilan dengan sakelar Jika QOS yang diinginkan tidak tersedia, maka fungsi gagal, tetapi panggilan berlanjut dengan QOS sebelumnya. Jika fungsi berhasil, informasi QOS baru disimpan di LINECALLINFO; pesan LINECALLINFOSTATE_QOS dikirim oleh penyedia layanan untuk menunjukkan nilai yang diperbarui.

Sintaks

LONG TSPIAPI TSPI_lineSetCallQualityOfService(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPVOID        lpSendingFlowspec,
  DWORD         dwSendingFlowspecSize,
  LPVOID        lpReceivingFlowspec,
  DWORD         dwReceivingFlowspecSize
);

Parameter

dwRequestID

Pengidentifikasi untuk melaporkan hasil fungsi asinkron.

hdCall

Penanganan penyedia layanan ke panggilan.

lpSendingFlowspec

Pointer ke memori yang berisi struktur WinSock2 FLOWSPEC diikuti oleh data khusus penyedia. Bagian khusus penyedia yang mengikuti struktur FLOWSPEC tidak boleh berisi pointer ke blok memori lain dalam proses aplikasi, karena TAPI tidak tahu cara membasmi data yang diarahkan oleh pointer privat dan menyampaikannya melalui komunikasi antarproses ke penyedia layanan.

dwSendingFlowspecSize

Ukuran total dalam byte FLOWSPEC dan data khusus penyedia yang menyertainya, setara dengan apa yang akan disimpan dalam SendingFlowspec.len dalam struktur QOS WinSock2.

lpReceivingFlowspec

Pointer ke memori yang berisi struktur WinSock2 FLOWSPEC diikuti oleh data khusus penyedia. Bagian khusus penyedia yang mengikuti struktur FLOWSPEC tidak boleh berisi pointer ke blok memori lain dalam proses aplikasi, karena TAPI tidak tahu cara membasmi data yang diarahkan oleh pointer privat dan menyampaikannya melalui komunikasi antarproses ke penyedia layanan.

dwReceivingFlowspecSize

Ukuran total dalam byte FLOWSPEC dan data khusus penyedia yang menyertainya, setara dengan apa yang akan disimpan dalam ReceivingFlowspec.len dalam struktur QOS WinSock2.

Mengembalikan nilai

Mengembalikan dwRequestID jika operasi asinkron dimulai; jika tidak, fungsi mengembalikan salah satu nilai kesalahan negatif ini:

LINEERR_INVALCALLSTATE, LINEERR_INVALRATE, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_RATEUNAVAIL, LINEERR_RESOURCEUNAVAIL.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tspi.h

Lihat juga

LINECALLINFO