Fungsi NdisCoDeleteVc (ndis.h)

Artikel
08/07/2023

NdisCoDeleteVc menghancurkan VC yang dibuat penelepon.

Sintaks

NDIS_STATUS NdisCoDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parameter

[in] NdisVcHandle

Menentukan handel yang mengidentifikasi VC yang akan dihapus. Pemanggil awalnya memperoleh handel ini dari NdisCoCreateVc.

Nilai kembali

NdisCoDeleteVc dapat mengembalikan salah satu hal berikut ini:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	NDIS menghapus VC.
NDIS_STATUS_NOT_ACCEPTED	VC masih aktif, sehingga tidak dapat dihapus.
NDIS_STATUS_CLOSING	Panggilan ini berlebihan, tetapi penonaktifan pada VC yang diberikan masih tertunda.

Keterangan

Ketika protokol memanggil NdisCoDeleteVc, tidak boleh ada panggilan luar biasa pada VC yang diberikan dan VC tersebut sudah dinonaktifkan. Untuk memenuhi persyaratan ini menyiratkan bahwa ketentuan berikut berlaku:

Jika panggilan dirobohkan dimulai oleh klien lokal, klien tersebut telah memanggil NdisClCloseCall dengan NdisVcHandle yang diberikan dan permintaan panggilan dekatnya telah berhasil diselesaikan.
Jika panggilan dirobek dimulai oleh klien jarak jauh, manajer panggilan mandiri telah memanggil NdisCmDeactivateVc dengan NdisVcHandle yang diberikan dan permintaan penonaktifannya telah berhasil diselesaikan.

Hanya protokol yang membuat VC tertentu yang dapat menghapus VC tersebut. Panggilan ke NdisCoDeleteVc menyebabkan NDIS memanggil fungsi MiniportCoDeleteVc driver miniport yang mendasar dan fungsi ProtocolCoDeleteVc dari klien atau manajer panggilan tempat pemanggil berbagi NdisVcHandle .

Ketika NdisCoDeleteVc mengembalikan kontrol, NdisVcHandle tidak lagi valid.

Manajer panggilan mandiri, yang mendaftarkan diri dengan NDIS sebagai driver protokol, dapat memanggil NdisCoDeleteVc. Driver miniport berorientasi koneksi yang menyediakan panggilan dukungan manajemen panggilan terintegrasi NdisMCmDeleteVc sebagai gantinya.

Persyaratan

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