Makro NdisMCmCloseCallComplete (ndis.h)

Artikel
03/01/2024

NdisMCmCloseCallComplete mengembalikan status akhir permintaan klien, yang sebelumnya dikembalikan driver MCM NDIS_STATUS_PENDING, untuk merobek panggilan.

Sintaks

void NdisMCmCloseCallComplete(
   _S_,
   _VH_,
   _PH_
);

Parameter

_S_

Menentukan status akhir permintaan klien bahwa driver MCM menutup koneksi, baik NDIS_STATUS_SUCCESS atau penelepon apa pun yang ditentukan NDIS_STATUS_XXX kecuali NDIS_STATUS_PENDING.

_VH_

Menentukan handel ke VC untuk panggilan. Handel ini disediakan oleh NDIS ketika VC awalnya dibuat, baik oleh driver MCM dengan NdisMCmCreateVc atau sebagai parameter input untuk fungsi ProtocolCoCreateVc-nya .

_PH_

Menentukan NULL jika NdisVcHandle mewakili VC point-to-point atau handel ke pihak terakhir yang tersisa pada koneksi multipoint, yang diperoleh driver MCM dari status per pihak yang ditetapkan oleh CallMgrPartyContext yang diteruskan sebagai parameter input ke dalamnya Fungsi ProtocolCmCloseCall .

Nilai kembali

Tidak ada

Keterangan

Jika fungsi ProtocolCmCloseCall driver MCM mengembalikan NDIS_STATUS_PENDING, ia harus memanggil NdisMCmCloseCallComplete untuk memberi tahu klien dan NDIS bahwa upayanya untuk memutuskan koneksi telah selesai, baik berhasil atau dengan kesalahan. Panggilan ke NdisMCmCloseCallComplete menyebabkan NDIS memanggil fungsi ProtocolClCloseCallComplete klien.

Jika melewati NDIS_STATUS_SUCCESS sebagai Status, driver MCM harus mempertimbangkan NdisVcHandle (dan NdisPartyHandle, jika ada) tidak dapat digunakan untuk transfer melalui jaringan segera setelah memanggil NdisMCmCloseCallComplete. Jika driver MCM awalnya membuat VC, driver harus memanggil NdisMCmDeleteVc dengan NdisVcHandle yang sama yang baru saja diteruskan ke NdisMCmCloseCallComplete. Jika klien membuat VC ini, driver MCM dapat mengharapkan panggilan ke fungsi ProtocolCoDeleteVc dengan
ProtocolVcContext, yang menunjuk status per-VC di mana ia telah menyimpan NdisVcHandle yang sama, sebagai parameter input.

Hanya driver miniport berorientasi koneksi yang menyediakan dukungan manajemen panggilan terintegrasi yang dapat memanggil NdisMCmCloseCallComplete. Manajer panggilan yang berdiri sendiri, yang mendaftarkan diri dengan NDIS sebagai driver protokol, panggil NdisCmCloseCallComplete sebagai gantinya.

Persyaratan

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