Memulai Modul Filter

Untuk memulai modul filter yang dijeda, NDIS memanggil fungsi FilterSetModuleOptions driver filter, jika ada, diikuti dengan panggilan ke fungsi FilterRestart. Modul filter memasuki status Menghidupkan Ulang pada awal eksekusi dalam fungsi FilterRestart.

Jika driver menyediakan titik masuk untuk FilterSetModuleOptions, driver dapat mengubah karakteristik parsial untuk modul filter. Untuk informasi selengkapnya, lihat Mode Bypass Data .

Saat memanggil fungsi FilterRestart, NDIS memberikan pointer ke struktur NDIS_RESTART_ATTRIBUTES ke driver filter dalam anggota RestartAttributes dari struktur NDIS_FILTER_RESTART_PARAMETERS. Driver filter dapat mengubah atribut penyalaan ulang yang ditentukan oleh driver yang mendasarinya. Untuk lebih banyak informasi tentang cara mengubah atribut mulai ulang, lihat FilterRestart.

Catatan NDIS memanggil FilterSetModuleOptions untuk semua modul filter dalam tumpukan sebelum NDIS memanggil fungsiFilterRestartuntuk setiap modul filter di dalam tumpukan.

NDIS memulai modul filter sebagai bagian dari operasi Plug and Play untuk memulai ulang tumpukan driver. Untuk gambaran umum memulai ulang tumpukan driver, lihat Memulai Ulang Driver Stack.

Atas nama modul filter yang berada dalam status Menghidupkan ulang, driver filter:

• Menyelesaikan operasi apa pun yang diperlukan untuk memulai ulang operasi kirim dan terima normal.

  Untuk informasi selengkapnya tentang operasi kirim dan terima, lihat Operasi Kirim dan Terima Modul Filter.

• Dapat membaca atau menulis parameter yang dapat dikonfigurasi untuk modul filter.

• Dapat menerima indikasi data jaringan. Driver dapat menyalin dan mengantrekan data tersebut dan memberitahukan ke driver di lapisan atas nanti, atau dapat membuang data.

• Tidak boleh memulai isyarat penerimaan yang baru.

• Harus menolak semua permintaan pengiriman baru yang dibuat ke fungsi FilterSendNetBufferLists dengan segera memanggil fungsi NdisFSendNetBufferListsComplete. Ini harus mengatur status lengkap di setiap NET_BUFFER_LIST ke NDIS_STATUS_PAUSED.

• Dapat memberikan indikasi status dengan fungsiNdisFIndicateStatus.

  Untuk informasi selengkapnya tentang indikasi status, lihat Indikasi Status Modul Filter.

• Harus menangani permintaan OID dalam fungsi FilterOidRequest.

  Untuk informasi selengkapnya tentang permintaan OID, lihat Permintaan OID untuk Modul Filter .

• Tidak boleh memulai permintaan pengiriman baru.

• Harus segera mengembalikan indikasi penerimaan baru ke NDIS dengan memanggil fungsi NdisFReturnNetBufferLists. Jika perlu, driver dapat menyalin indikasi terima tersebut sebelum mengembalikannya.

• Dapat membuat permintaan OID ke driver dasar untuk mengatur atau menanyakan informasi konfigurasi yang diperbarui.

• Harus menangani indikasi status dalam fungsi FilterStatus.

• Seharusnya menunjukkan NDIS_STATUS_SUCCESS atau status kegagalan. Jika modul filter tidak dimulai ulang, NDIS akan mencopotnya dan jika merupakan filter wajib, NDIS mengakhiri seluruh tumpukan driver.

Setelah pengandar filter berhasil memulai ulang operasi kirim dan terima, pengandar harus menyelesaikan operasi mulai ulang. Driver filter dapat menyelesaikan operasi memulai ulang secara sinkron atau asinkron dengan mengembalikan NDIS_STATUS_SUCCESS atau NDIS_STATUS_PENDING masing-masing dari FilterRestart.

Jika driver mengembalikan NDIS_STATUS_PENDING, driver harus memanggil fungsiNdisFRestartComplete setelah menyelesaikan operasi hidupkan ulang. Dalam hal ini, driver mengirimkan status akhir operasi hidupkan ulang ke NdisFRestartComplete.

Setelah operasi hidupkan ulang selesai, modul filter berada dalam status Berjalan. Driver melanjutkan pemrosesan kirim dan terima normal.

NDIS tidak memulai operasi Plug and Play lainnya, seperti, melampirkan, melepaskan, atau menjeda permintaan, saat driver filter berada dalam status Memulai Ulang. NDIS dapat memulai permintaan jeda setelah driver filter berada dalam keadaan berjalan. Untuk informasi selengkapnya tentang menjeda modul filter, lihat Menjeda Modul Filter.