Fungsi NdisMCoActivateVcComplete (ndis.h)

Artikel
02/26/2024

NdisMCoActivateVcComplete memberi tahu NDIS dan manajer panggilan bahwa driver miniport telah selesai memproses permintaan activate-VC yang dimulai CM, yang sebelumnya dikembalikan driver miniport NDIS_STATUS_PENDING.

Sintaks

void NdisMCoActivateVcComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parameter

[in] Status

Menentukan status akhir operasi activate-VC, yang dapat NDIS_STATUS_SUCCESS atau NDIS_STATUS_ XXX kecuali NDIS_STATUS_PENDING.

[in] NdisVcHandle

Menentukan handel yang mengidentifikasi VC. Pemanggil memperoleh handel ini dari status per VC-nya, yang ditunjuk oleh MiniportVcContext yang diteruskan sebagai parameter input ke Fungsi MiniportCoActivateVc .

[in] CallParameters

Penunjuk ke struktur jenis CO_CALL_PARAMETERS, yang disediakan oleh manajer panggilan, menentukan parameter panggilan dan media untuk aktivasi VC.

Nilai kembali

Tidak ada

Keterangan

Driver miniport berorientasi koneksi harus memanggil NdisMCoActivateVcComplete jika fungsi MiniportCoActivateVc sebelumnya dikembalikan NDIS_STATUS_PENDING sebagai respons terhadap permintaan untuk mengaktifkan atau mengaktifkan kembali VC yang diidentifikasi oleh NdisVcHandle yang diberikan. Manajer panggilan, yang memulai aktivasi VC dengan panggilan ke NdisCmActivateVc, tidak dapat memberi tahu NDIS atau kliennya apakah transfer pada VC dapat dilakukan menggunakan parameter panggilan yang disediakan sampai driver miniport memanggil NdisMCoActivateVcComplete.

Jika driver miniport menemukan parameter panggilan yang disediakan CM tidak dapat diterima, itu gagal aktivasi VC saat memanggil NdisMCoActivateVcComplete. Gagalnya aktivasi awal VC dapat menyebabkan protokol yang membuat VC merobeknya. Jika driver miniport gagal meminta untuk mengaktifkan kembali VC yang dibuat dengan parameter panggilan baru, driver tersebut harus memulihkan parameter panggilan asli yang ditetapkan untuk VC tersebut. Bergantung pada sifat media jaringan, driver miniport dapat memodifikasi parameter media jika bendera round-up dan/atau round-down diatur sebelum memanggil NdisMCoActivateVcComplete.

Panggilan ke NdisMCoActivateVcComplete menyebabkan NDIS memanggil Fungsi ProtocolCmActivateVcComplete dari manajer panggilan yang awalnya meminta aktivasi VC.

Persyaratan

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