Makro NdisMCmDispatchIncomingCall (ndis.h)

Artikel
08/07/2023

NdisMCmDispatchIncomingCall memberi tahu klien tentang panggilan masuk pada SAP yang sebelumnya didaftarkan oleh klien tersebut dengan driver MCM.

Sintaks

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

Parameter

_SH_

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

_VH_

Menentukan handel yang mengidentifikasi VC, dibuat dengan NdisMCmCreateVc ketika driver MCM memproses penawaran panggilan masuk yang diarahkan ke SAP terdaftar ini.

_CP_

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

Nilai kembali

Tidak ada

Keterangan

Sebelum memanggil NdisMCmDispatchIncomingCall, driver MCM telah melakukan hal berikut:

Mengidentifikasi target SAP, yang sebelumnya didaftarkan oleh klien tertentu, untuk panggilan (sebenarnya, permintaan untuk membuat koneksi) yang diterimanya melalui jaringan
Membuat VC untuk panggilan masuk dengan NdisMCmCreateVc
Mungkin dinegosiasikan tentang parameter panggilan yang dapat diterima melalui jaringan, atau menerima parameter panggilan yang dikirim dari simpul jarak jauh
Mengaktifkan VC dengan NdisMCmActivateVc untuk memberi tahu NDIS bahwa VC siap untuk ditransfer sesuai dengan parameter panggilan yang dinegosiasikan atau diterima

Panggilan driver MCM ke NdisMCmDispatchIncomingCall 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 fungsi ProtocolCmIncomingCallComplete driver MCM. Jika klien menerima panggilan, driver MCM akan menelepon berikutnya NdisMCmDispatchCallConnected. Jika tidak, VC akan dinonaktifkan (dan mungkin menghapus) VC yang dibuatnya, setelah memberi tahu simpul jarak jauh bahwa panggilan yang ditawarkan ditolak.

Hanya driver miniport berorientasi koneksi yang menyediakan panggilan dukungan manajemen panggilan terintegrasi NdisMCmDispatchIncomingCall. Manajer panggilan mandiri, yang mendaftarkan diri dengan NDIS sebagai driver protokol, panggil NdisCmDispatchIncomingCall sebagai gantinya.

Persyaratan

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