lineSetCallQualityOfService (tapi.h)

Artikel
08/26/2023

Fungsi lineSetCallQualityOfService memungkinkan aplikasi untuk mencoba mengubah kualitas parameter layanan (jaminan kapasitas dan performa yang dipesan) untuk panggilan yang ada. Kecuali untuk validasi parameter dasar, ini adalah pass-through langsung ke penyedia layanan.

Sintaks

LONG lineSetCallQualityOfService(
  HCALL  hCall,
  LPVOID lpSendingFlowspec,
  DWORD  dwSendingFlowspecSize,
  LPVOID lpReceivingFlowspec,
  DWORD  dwReceivingFlowspecSize
);

Parameter

hCall

Tangani panggilan. Aplikasi harus memiliki hak istimewa PEMILIK.

lpSendingFlowspec

Pointer ke memori yang berisi struktur 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 akan tahu cara membasmi data yang diarahkan oleh pointer privat dan menyampaikannya melalui komunikasi antarproses ke penyedia layanan.

dwSendingFlowspecSize

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

lpReceivingFlowspec

Pointer ke memori yang berisi struktur 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 akan tahu cara membasmi data yang diarahkan oleh pointer privat dan menyampaikannya melalui komunikasi antarproses ke penyedia layanan.

dwReceivingFlowspecSize

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

Nilai kembali

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

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_INVALRATE, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED, LINEERR_RATEUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.