FILTER_DETACH fungsi panggilan balik (ndis.h)

Artikel
02/26/2024

NDIS memanggil fungsi FilterDetach driver filter untuk merilis semua sumber daya yang terkait dengan modul filter.

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

Sintaks

FILTER_DETACH FilterDetach;

void FilterDetach(
  [in] NDIS_HANDLE FilterModuleContext
)
{...}

Parameter

[in] FilterModuleContext

Handel ke area konteks untuk modul filter yang akan dihapus NDIS dari tumpukan driver. Driver filter membuat dan menginisialisasi area konteks ini dalam fungsi FilterAttach .

Nilai kembali

Tidak ada

Keterangan

FilterDetach adalah fungsi yang diperlukan. NDIS memanggil FilterDetach untuk menghapus modul filter dari tumpukan driver. NDIS memanggil FilterDetach saat modul filter dalam status Dijeda .

FilterDetach membebaskan area konteks driver dan sumber daya lainnya (seperti kumpulan buffer) untuk modul filter yang terpengaruh.

Setelah driver filter kembali dari FilterDetach, modul filter berada dalam status Dilepas .

NDIS memanggil FilterDetach di IRQL = PASSIVE_LEVEL.

Contoh

Untuk menentukan fungsi FilterDetach , 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 FilterDetach yang diberi nama "MyDetach", gunakan jenis FILTER_DETACH seperti yang ditunjukkan dalam contoh kode ini:

FILTER_DETACH MyDetach;

Kemudian, terapkan fungsi Anda sebagai berikut:

_Use_decl_annotations_
VOID
 MyDetach(
    NDIS_HANDLE  FilterModuleContext
    )
  {...}

Jenis fungsi FILTER_DETACH ditentukan 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 FILTER_DETACH 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 di NDIS 6.0 dan yang lebih baru.
Target Platform	Windows
Header	ndis.h (termasuk Ndis.h)
IRQL	PASSIVE_LEVEL

Lihat juga

FilterAttach

Bagikan melalui