Fungsi NdisCmDispatchIncomingCallQoSChange (ndis.h)

Artikel
03/01/2024

NdisCmDispatchIncomingCallQoSChange memberi tahu klien bahwa permintaan untuk mengubah kualitas layanan pada koneksi aktif klien tersebut telah diterima melalui jaringan.

Sintaks

void NdisCmDispatchIncomingCallQoSChange(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parameter

[in] NdisVcHandle

Menentukan handel ke VC tempat perubahan QoS diminta. Manajer panggilan awalnya memperoleh handel ini baik ketika disebut NdisCoCreateVc untuk menyiapkan koneksi ini untuk panggilan masuk atau sebagai parameter input ke fungsi ProtocolCoCreateVc-nya .

[in] CallParameters

Penunjuk ke struktur jenis CO_CALL_PARAMETERS yang menentukan QoS baru, yang diminta oleh klien pada simpul jarak jauh, untuk koneksi ini.

Nilai kembali

Tidak ada

Keterangan

Manajer panggilan mandiri memanggil NdisCmDispatchIncomingCallQoSChange untuk memberi tahu klien bahwa ia telah menerima permintaan untuk memodifikasi QoS pada koneksi aktif. CM seperti itu mendukung perubahan QoS dinamis pada panggilan aktif, yang merupakan fitur seperti QoS itu sendiri yang tergantung pada protokol sinyal.

Ketika CM sendiri menerima permintaan perubahan QoS, manajer panggilan meneruskan parameter panggilan yang dimodifikasi dengan tepat ke NdisCmActivateVc, sehingga driver miniport yang mendasar juga diberi tahu tentang perubahan QoS yang diusulkan. Dengan asumsi driver miniport yang mendasarinya menerima parameter panggilan yang diubah, CM kemudian memanggil NdisCmDispatchIncomingCallQoSChange.

Panggilan ke NdisCmDispatchIncomingCallQoSChange menyebabkan NDIS memanggil fungsi ProtocolClIncomingQoSChange klien. Klien menerima modifikasi yang diusulkan ke parameter panggilan untuk VC dengan tidak melakukan apa pun, kecuali mungkin memperbarui status apa pun yang dipertahankannya tentang QoS untuk VC, dan mengembalikan kontrol. Jika tidak, klien menolak perubahan QoS yang diusulkan dengan merobek panggilan.

Hanya manajer panggilan mandiri, yang mendaftarkan diri dengan NDIS sebagai driver protokol, yang dapat memanggil NdisCmDispatchIncomingCallQoSChange. Driver miniport berorientasi koneksi yang menyediakan panggilan dukungan manajemen panggilan terintegrasi NdisMCmDispatchIncomingCallQoSChange sebagai gantinya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) di Windows XP.
Target Platform	Desktop
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_CallManager_Function(ndis)