Fungsi NdisMCmDeactivateVc (ndis.h)

Artikel
03/08/2023

NdisMCmDeactivateVc memberi tahu NDIS bahwa tidak akan ada transfer lebih lanjut pada VC aktif tertentu.

Sintaks

NDIS_STATUS NdisMCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parameter

[in] NdisVcHandle

Menentukan handel yang mengidentifikasi VC. Handel ini disediakan oleh NDIS ke driver MCM baik ketika disebut NdisMCmCreateVc untuk panggilan masuk atau ketika fungsi ProtocolCoCreateVc menyiapkan VC untuk panggilan keluar yang dimulai klien.

Nilai kembali

NdisMCmDeactivateVc dapat mengembalikan salah satu hal berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	NDIS menandai VC sebagai tidak aktif.
NDIS_STATUS_NOT_ACCEPTED	VC sudah dinonaktifkan, jadi panggilan ini berlebihan.

Keterangan

Driver MCM memanggil NdisMCmDeactivateVc sebagai langkah penting dalam menutup panggilan, biasanya setelah pertukaran paket dengan komponen jaringan yang merobek koneksi.

Panggilan yang berhasil ke NdisMCmDeactivateVc memungkinkan driver MCM membuang parameter panggilan saat ini untuk transfer pada VC, mungkin menginisialisasinya kembali untuk meminimalkan nilai default yang ditentukan driver. Namun, jika VC diaktifkan kembali kemudian untuk panggilan lain, klien akan menyediakan parameter panggilan baru ke driver miniport.

NdisVcHandle yang diteruskan ke NdisMCmDeactivateVc tetap valid setelah penonaktifan VC selesai. Penonaktifan VC apa pun memungkinkan pembuatnya untuk menginisialisasi ulang VC untuk digunakan kembali atau untuk menghancurkannya:

Setelah penonaktifan VC dan penutupan panggilan, klien dapat menggunakan kembali VC yang awalnya dibuat untuk melakukan panggilan lain dengan NdisClMakeCall, atau dapat memanggil NdisCoDeleteVc, sehingga menyebabkan panggilan ke fungsi ProtocolCoDeleteVc driver MCM.
Setelah penonaktifan VC dan penutupan panggilan, driver MCM dapat menggunakan kembali VC yang awalnya dibuat untuk menunjukkan panggilan masuk lain ke klien yang sama dengan NdisMCmDispatchIncomingCall, atau dapat memanggil NdisMCmDeleteVc.

Penulis driver menentukan apakah driver MCM memiliki fungsi MiniportCoDeactivateVc (internal) yang dipanggil driver dalam konteks merobek koneksi untuk panggilan keluar dan masuk.

Hanya driver miniport berorientasi koneksi yang menyediakan dukungan manajemen panggilan terintegrasi yang dapat memanggil NdisMCmDeactivateVc. Manajer panggilan mandiri, yang mendaftarkan diri dengan NDIS sebagai driver protokol, panggil NdisCmDeactivateVc sebagai gantinya.

Persyaratan

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