Fungsi NdisCmDeactivateVc (ndis.h)

NdisCmDeactivateVc memberi tahu NDIS dan driver miniport yang mendasar bahwa tidak akan ada transfer lebih lanjut pada VC aktif tertentu.

Sintaks

NDIS_STATUS NdisCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parameter

[in] NdisVcHandle

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

Mengembalikan nilai

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

Keterangan

Manajer panggilan mandiri memanggil NdisCmDeactivateVc sebagai langkah penting dalam menutup panggilan, biasanya setelah pertukaran paket dengan komponen jaringan yang merobek panggilan.

Panggilan ke NdisCmDeactivateVc menyebabkan NDIS memanggil fungsi MiniportCoDeactivateVc driver miniport yang mendasar, yang dapat membuang parameter panggilan saat ini untuk transfer pada VC, mungkin menginisialisasinya kembali untuk meminimalkan nilai default yang ditentukan driver. Jika VC diaktifkan kembali kemudian untuk panggilan lain, klien atau manajer panggilan akan menyediakan parameter panggilan baru ke driver miniport.

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

  • Setelah penonaktifan VC dan penutupan panggilan, klien dapat menggunakan kembali VC yang awalnya dibuat untuk melakukan panggilan lain dengan NdisClMakeCall.
  • Setelah penonaktifan VC dan penutupan panggilan, CM dapat menggunakan kembali VC yang awalnya dibuat untuk menunjukkan panggilan masuk lain ke klien yang sama dengan NdisCmDispatchIncomingCall.
Pembuat VC tertentu yang tidak akan digunakan kembali memanggil NdisCoDeleteVc untuk menghancurkan VC tersebut.

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

Persyaratan

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

Lihat juga

MiniportCoDeactivateVc

NdisClCloseCall

NdisClMakeCall

NdisCmActivateVc

NdisCmDispatchIncomingCall

NdisMCmDeactivateVc

ProtocolCmCloseCall

ProtocolCmDeactivateVcComplete