Menjeda Modul Filter

Untuk menjeda modul filter yang sedang berjalan, NDIS memanggil fungsi driver filter FilterPause. Modul filter memasuki keadaan Menjeda pada awal eksekusi dalam fungsi FilterPause.

NDIS menjeda modul filter sebagai bagian dari operasi Plug and Play untuk menjeda tumpukan driver. Untuk gambaran umum tentang menjeda rangkaian driver, lihat Menjeda Rangkaian Driver.

Atas nama modul filter yang berada dalam status jeda, driver filter:

• Tidak boleh membuat sinyal penerimaan baru.

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

• Jika ada operasi penerimaan yang berasal dari driver filter yang NDIS belum selesaikan, driver filter harus menunggu NDIS menyelesaikan operasi tersebut. Operasi jeda tidak selesai sampai NDIS memanggil fungsi FilterReturnNetBufferLists untuk semua indikasi penerimaan yang beredar tersebut.

• Harus segera mengembalikan indikasi penerimaan yang belum diproses yang dihasilkan oleh driver dasar ke NDIS. Operasi jeda tidak selesai sampai driver memanggil fungsi NdisFReturnNetBufferLists untuk indikasi penerimaan yang belum diselesaikan tersebut. Indikasi penerimaan tertunda ini bisa ada jika driver mengantrekan buffer yang diterimanya dari driver yang di bawahnya.

• Harus segera mengembalikan indikasi penerimaan baru bahwa driver yang mendasar dialihkan ke NDIS dengan memanggil fungsi NdisFReturnNetBufferLists. Jika perlu, driver dapat menyalin indikasi penerimaan dan mengantrekannya sebelum mengembalikannya.

  CatatanNdisFReturnNetBufferLists tidak boleh dipanggil untuk NBL yang ditunjukkan dengan pengaturan bendera NDIS_RECEIVE_FLAGS_RESOURCES dalam panggilan FilterReceiveNetBufferLists yang sesuai. NBL tersebut dikembalikan ke NDIS secara sinkron dengan kembali dari fungsi FilterReceiveNetBufferLists.

• Tidak boleh membuat permintaan pengiriman baru.

• Jika ada operasi pengiriman yang berasal dari driver filter dan NDIS belum selesai, driver filter harus menunggu NDIS menyelesaikan operasi tersebut. Operasi jeda tidak lengkap sampai NDIS memanggil fungsi FilterSendNetBufferListsComplete untuk semua permintaan pengiriman yang tertunda tersebut.

• Harus segera mengembalikan semua permintaan pengiriman baru yang dibuat ke fungsi FilterSendNetBufferLists dengan memanggil fungsi NdisFSendNetBufferListsComplete. Driver filter harus mengatur anggota Status di dalam setiap struktur NET_BUFFER_LIST menjadi NDIS_STATUS_PAUSED.

• Dapat memberikan indikasi status dengan fungsiNdisFIndicateStatus.

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

• Harus menangani indikasi status dalam fungsi FilterStatus.

• Harus menangani permintaan OID dalam fungsi FilterOidRequest.

  Untuk informasi selengkapnya tentang permintaan OID, lihat Filter Module Permintaan OID .

• Mampu memulai permintaan OID.

• Tidak boleh membebaskan sumber daya yang dialokasikan oleh driver pada operasi penyambungan.

• Harus membatalkan timer jika diperlukan untuk menghentikan operasi pengiriman dan penerimaan.

  Untuk informasi lebih lanjut tentang timer, lihat NDIS 6.0 Timer Services.

Setelah driver filter berhasil menjeda operasi kirim dan terima, driver filter harus menyelesaikan operasi jeda. Driver filter dapat menyelesaikan operasi jeda secara sinkron atau asinkron dengan mengembalikan NDIS_STATUS_SUCCESS atau NDIS_STATUS_PENDING masing-masing dari FilterPause.

Jika driver mengembalikan NDIS_STATUS_PENDING, driver harus memanggil fungsiNdisFPauseComplete setelah menyelesaikan operasi jeda.

Atas nama modul filter yang berada dalam status Dijeda, driver filter:

• Tidak harus berasal dari petunjuk penerimaan baru.

• Harus segera mengembalikan indikasi penerima baru bahwa driver yang mendasar berasal dari NDIS dengan memanggil fungsi NdisFReturnNetBufferLists. Jika perlu, driver dapat menyalin indikasi penerimaan dan mengantrekannya sebelum mengembalikannya.

• Tidak boleh mengajukan permintaan pengiriman baru.

• Harus segera mengembalikan semua permintaan pengiriman baru yang dibuat ke fungsi FilterSendNetBufferLists dengan memanggil fungsi NdisFSendNetBufferListsComplete. Driver filter harus mengatur anggota Status di dalam setiap struktur NET_BUFFER_LIST menjadi NDIS_STATUS_PAUSED.

• Dapat memberikan indikasi status dengan fungsiNdisFIndicateStatus.

• Harus menangani indikasi status dalam fungsi FilterStatus.

• Harus menangani permintaan OID dalam fungsi FilterOidRequest.

• Mampu memulai permintaan OID.

NDIS tidak memulai operasi Plug and Play lainnya, seperti, melampirkan, melepaskan, atau memulai ulang permintaan, saat driver filter berada dalam status Menjeda. NDIS dapat memulai permintaan pencopotan atau memulai ulang setelah driver filter berada dalam status Dijeda. Untuk informasi selengkapnya tentang cara melepaskan modul filter, lihat Melepaskan Modul Filter. Untuk informasi selengkapnya tentang cara memulai ulang modul filter, lihat Memulai Modul Filter.