Fungsi NdisFRegisterFilterDriver (ndis.h)

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.

Mengembalikan nilai

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

   
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)

Lihat juga

DriverEntry dari Driver Filter NDIS

FilterAttach

Menginisialisasi Driver Filter

NDIS_FILTER_DRIVER_CHARACTERISTICS

NdisFDeregisterFilterDriver

NdisSetOptionalHandlers