PROTOCOL_CO_DELETE_VC fungsi panggilan balik (ndis.h)

Artikel
08/07/2023

Fungsi ProtocolCoDeleteVc diperlukan. Fungsi ini meluapkan status klien atau manajer panggilan untuk koneksi virtual yang dibuat yang ditutup oleh pembuat asli VC tersebut.

Catatan Anda harus mendeklarasikan fungsi dengan menggunakan jenis PROTOCOL_CO_DELETE_VC . Untuk informasi selengkapnya, lihat bagian Contoh berikut ini.

Sintaks

PROTOCOL_CO_DELETE_VC ProtocolCoDeleteVc;

NDIS_STATUS ProtocolCoDeleteVc(
  [in] NDIS_HANDLE ProtocolVcContext
)
{...}

Parameter

[in] ProtocolVcContext

Menentukan handel ke area konteks per VC klien atau manajer panggilan. Protokol awalnya menyediakan handel ini dari fungsi ProtocolCoCreateVc .

Nilai kembali

ProtocolCoDeleteVc dapat mengembalikan salah satu hal berikut ini:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Protokol telah dirilis atau disiapkan untuk menggunakan kembali semua sumber daya yang awalnya dialokasikan untuk VC.
NDIS_STATUS_NOT_ACCEPTED	VC masih aktif dan protokol memiliki operasi luar biasa yang tertunda pada VC sehingga tidak dapat dihancurkan.
NDIS_STATUS_XXX	Protokol gagal menghapus VC karena alasan yang ditentukan driver.

Keterangan

ProtocolCoDeleteVc adalah timbal balik dari fungsi ProtocolCoCreateVc driver. Secara umum, ia merilis sumber daya dan struktur dinamis apa pun yang dialokasikan manajer panggilan atau klien sebelumnya untuk melakukan operasi pada VC aktif.

Ketika ProtocolCoDeleteVc mengembalikan kontrol dengan NDIS_STATUS_SUCCESS, NdisVcHandle bahwa fungsi ProtocolCoCreateVc yang disimpan di area di ProtocolVcContext menjadi tidak valid.

ProtocolCoDeleteVc dapat mengembalikan NDIS_STATUS_XXXX yang ditentukan driver untuk gagal menghapus VC, tetapi tidak dapat mengembalikan NDIS_STATUS_PENDING. Panggilan ke ProtocolCoDeleteVc secara inheren bersifat sinkron.

Contoh

Untuk menentukan fungsi ProtocolCoDeleteVc , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis fungsi yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi untuk pengandar. Mendeklarasikan fungsi menggunakan jenis fungsi membantu Analisis Kode untuk Driver, Pemverifikasi Driver Statis (SDV), dan alat verifikasi lainnya menemukan kesalahan, dan itu adalah persyaratan untuk menulis driver untuk sistem operasi Windows.

Misalnya, untuk menentukan fungsi ProtocolCoDeleteVc yang diberi nama "MyCoDeleteVc", gunakan jenis PROTOCOL_CO_DELETE_VC seperti yang ditunjukkan dalam contoh kode ini:

PROTOCOL_CO_DELETE_VC MyCoDeleteVc;

Kemudian, terapkan fungsi Anda sebagai berikut:

_Use_decl_annotations_
NDIS_STATUS
 MyCoDeleteVc(
    NDIS_HANDLE  ProtocolVcContext
    )
  {...}

Jenis fungsi PROTOCOL_CO_DELETE_VC didefinisikan dalam file header Ndis.h. Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan anotasi Use_decl_annotations ke definisi fungsi Anda. Anotasi Use_decl_annotations memastikan bahwa anotasi yang diterapkan ke jenis fungsi PROTOCOL_CO_DELETE_VC dalam file header digunakan. Untuk informasi selengkapnya tentang persyaratan untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi dengan Menggunakan Jenis Peran Fungsi untuk Driver NDIS.

Untuk informasi tentang Use_decl_annotations, lihat Perilaku Fungsi Anotasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat ProtocolCoDeleteVc (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat ProtocolCoDeleteVc (NDIS 5.1)) di Windows XP.
Target Platform	Windows
Header	ndis.h (termasuk Ndis.h)
IRQL	<= DISPATCH_LEVEL