Fungsi NdisCmDispatchIncomingCall (ndis.h)

Artikel
08/07/2023

NdisCmDispatchIncomingCall memberi tahu klien tentang panggilan masuk pada SAP yang sebelumnya didaftarkan oleh klien tersebut.

Sintaks

NDIS_STATUS NdisCmDispatchIncomingCall(
  [in] NDIS_HANDLE         NdisSapHandle,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parameter

[in] NdisSapHandle

Menentukan handel yang mengidentifikasi SAP. NDIS menyiapkan handel ini ketika klien awalnya memanggil NdisClRegisterSap, dan manajer panggilan awalnya memperoleh handel ini sebagai parameter input untuk Fungsi ProtocolCmRegisterSap .

[in] NdisVcHandle

Menentukan handel yang mengidentifikasi VC, dibuat dengan NdisCoCreateVc ketika manajer panggilan memproses penawaran panggilan masuk yang diarahkan ke SAP terdaftar ini.

[in] CallParameters

Penunjuk ke struktur jenis CO_CALL_PARAMETERS yang menentukan parameter lalu lintas dan media untuk VC.

Nilai kembali

Ketika NdisCmDispatchIncomingCall mengembalikan apa pun selain NDIS_STATUS_PENDING, manajer panggilan harus melakukan panggilan internal ke Fungsi ProtocolCmIncomingCallComplete . Jika tidak, NDIS memanggil fungsi ProtocolCmIncomingCallComplete CM ketika operasi ini selesai.

Keterangan

Sebelum memanggil NdisCmDispatchIncomingCall, manajer panggilan mandiri telah melakukan hal berikut:

Mengidentifikasi SAP target, yang sebelumnya didaftarkan oleh klien tertentu, untuk panggilan (sebenarnya, permintaan untuk membuat koneksi) yang diterimanya melalui jaringan
Membuat VC untuk panggilan masuk dengan NdisCoCreateVc
Mungkin dinegosiasikan tentang parameter panggilan yang dapat diterima melalui jaringan, atau menerima parameter panggilan yang dikirim dari simpul jarak jauh
Mengaktifkan VC dengan NdisCmActivateVc, menyebabkan driver miniport yang mendasar membuat dirinya siap untuk transfer pada VC sesuai dengan parameter panggilan yang dinegosiasikan atau diterima

Panggilan CM ke NdisCmDispatchIncomingCall menyebabkan NDIS memanggil fungsi ProtocolClIncomingCall klien, di mana klien menerima atau menolak koneksi yang diminta. Setelah memutuskan apakah akan menerima koneksi, klien memanggil NdisClIncomingCallComplete, yang, pada gilirannya, memanggil CM Fungsi ProtocolCmIncomingCallComplete . Jika klien menerima panggilan, CM selanjutnya memanggil NdisCmDispatchCallConnected. Jika tidak, VC akan dinonaktifkan (dan mungkin menghapus) VC yang dibuatnya, setelah memberi tahu simpul jarak jauh bahwa panggilan yang ditawarkan ditolak.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisCmDispatchIncomingCall (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisCmDispatchIncomingCall (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)