Fungsi NdisFRegisterFilterDriver (ndis.h)

Artikel
02/26/2024

Driver filter memanggil Fungsi NdisFRegisterFilterDriver untuk mendaftarkan fungsi FilterXxx-nya dengan NDIS.

Sintaks

NDIS_STATUS NdisFRegisterFilterDriver(
  [in]  PDRIVER_OBJECT                      DriverObject,
  [in]  NDIS_HANDLE                         FilterDriverContext,
        PNDIS_FILTER_DRIVER_CHARACTERISTICS FilterDriverCharacteristics,
  [out] PNDIS_HANDLE                        NdisFilterDriverHandle
);

Parameter

[in] DriverObject

Penunjuk ke objek driver buram yang diterima driver filter dalam rutinitas DriverEntry-nya pada parameter Argument1 . (Untuk informasi selengkapnya, lihat DriverEntry driver filter NDIS.)

[in] FilterDriverContext

Handel ke area konteks yang dialokasikan driver tempat driver mempertahankan informasi status dan konfigurasi.

FilterDriverCharacteristics

Penunjuk ke NDIS_FILTER_DRIVER_CHARACTERISTICS struktur driver filter yang dibuat dan diinisialisasi dengan titik entri fungsi FilterXxx-nya .

[out] NdisFilterDriverHandle

Penunjuk ke variabel handel. Jika panggilan ke NdisFRegisterFilterDriver berhasil, NDIS mengisi variabel ini dengan handel driver filter. Driver filter menyimpan handel ini dan kemudian meneruskan handel ini ke fungsi NDIS, seperti NdisFDeregisterFilterDriver, yang memerlukan handel driver filter sebagai parameter input.

Nilai kembali

NdisFRegisterFilterDriver mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	NdisFRegisterFilterDriver mengembalikan NDIS_STATUS_SUCCESS jika mendaftarkan driver filter.
NDIS_STATUS_BAD_VERSION	Versi yang ditentukan dalam anggota MajorNdisVersion dari struktur di FilterCharacteristics tidak valid.
NDIS_STATUS_BAD_CHARACTERISTICS	Setidaknya salah satu anggota yang ditentukan dalam NDIS_FILTER_DRIVER_CHARACTERISTICS tidak valid.
NDIS_STATUS_INVALID_PARAMETER	Setidaknya salah satu parameter input yang diteruskan driver NdisFRegisterFilterDriver tidak valid.
NDIS_STATUS_RESOURCES	NdisFRegisterFilterDriver gagal karena sumber daya yang tidak mencukupi.
NDIS_STATUS_FAILURE	NdisFRegisterFilterDriver mengembalikan NDIS_STATUS_FAILURE jika tidak ada nilai sebelumnya yang berlaku.

Keterangan

Driver filter memanggil Fungsi NdisFRegisterFilterDriver dari rutinitas DriverEntry-nya . Untuk informasi selengkapnya tentang DriverEntry, lihat DriverEntry driver filter NDIS.

Driver yang memanggil NdisFRegisterFilterDriver harus siap untuk panggilan langsung ke salah satu fungsi FilterXxx mereka. Untuk informasi selengkapnya, lihat Menginisialisasi Driver Filter.

Setiap driver filter mengekspor sekumpulan fungsi FilterXxx dengan menyiapkan NDIS_FILTER_DRIVER_CHARACTERISTICS struktur dan panggilan NdisFRegisterFilterDriver. NDIS menyalin struktur ini ke penyimpanan internal pustaka NDIS.

Untuk mengizinkan driver filter mendaftarkan layanan opsional, NDIS memanggil fungsi FilterSetOptions dalam konteks NdisFRegisterFilterDriver.

Setelah terdaftar, driver filter nantinya dapat memanggil fungsi NdisSetOptionalHandlers untuk mengubah titik masuk untuk fungsi FilterXxx opsional.

Driver filter memanggil Fungsi NdisFDeregisterFilterDriver untuk merilis sumber daya yang sebelumnya dialokasikan dengan NdisFRegisterFilterDriver.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform	Desktop
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	Irql_Filter_Driver_Function(ndis), NdisFDeregisterFilterDriver(ndis)