Filtre Modülü Ekleme

NDIS, bir sürücü yığınına filtre modülü ekleme işlemini başlatmak için filtre sürücüsünün FilterAttachişleviniçağırır. FilterAttach işlevi yürütülmeye başladığında, filtre modülü Bağlanma durumuna girer. Sürücü yığınına filtre modülü ekleme hakkında daha fazla bilgi için bkz. Sürücü Yığını Başlatma.

Filtre sürücüsü, NDIS'nin bu filtre modülüne başvuran tüm gelecekteki NdisXxx işlev çağrılarında, FilterAttachNdisFilterHandle parametresinde ilettiği tanıtıcıyı kullanır. Bu tür işlevler durum göstergelerini, istekleri göndermeyi, alma göstergelerini ve OID isteklerini içerir.

Bir filtre modülü ekleme durumundayken, sürücü:

• Filtre modülü için bir bağlam alanı oluşturur ve arabellek havuzlarını ve filtre modülüne özgü diğer kaynakları ayırır. Arabellek havuzları hakkında daha fazla bilgi için bkz. Filtre Sürücüsü Arabellek Yönetimi.

• NDIS'nin FilterAttachifadesiyle ilettiği NdisFilterHandle değerini kullanarak NdisFSetAttributes işlevini çağırır. NdisFSetAttributesFilterModuleContext parametresi, bu filtre modülü için filtre sürücüsünün bağlam alanını belirtir. NDIS bu bağlam alanını filtre sürücüsünün FilterXxx işlevlerine geçirir.

• İsteğe bağlı olarak, bu filtre modülü için yapılandırma parametrelerini kayıt defterinden okur. Daha fazla bilgi için bkz. Filtre Sürücüsüiçin Yapılandırma Bilgilerine Erişme.

• Önceki işlemler başarıyla tamamlandıysa, filtre modülü Duraklatıldı durumundadır.

• Önceki işlemler başarısız olursa, filtre sürücüsünün FilterAttach işlevinde ayırmış olduğu tüm kaynakları serbest bırakması ve filtre modülünü ayrılmış durumuna döndürmesi gerekir.

• NDIS_STATUS_SUCCESS veya uygun bir hata kodu döndürür. Sürücü bir hata kodu döndürürse, NDIS sürücü yığınını sonlandırır.

Not Kayıt defteri, filtre modülünün isteğe bağlı olduğunu belirten bir bayrak içerebilir. İsteğe bağlı bir filtre modülü eklenmezse, NDIS sürücü yığınının geri kalanını sonlandırmaz.

Filtre sürücüsü istek gönderemez, alınan verileri belirtemez, OID istekleri yapamaz veya Ekleme durumundan durum göstergeleri yapamaz. Gönderme ve alma işlemleri Çalışma ve Duraklatma durumlarında desteklenir. OID istekleri ve durum göstergeleri Duraklatıldı, Yeniden Başlatılıyor, Çalışıyorve Duraklatılıyor durumlarında desteklenir.

NDIS, NDIS'nin FilterAttachile eklediği bir filtre modülünü ayırmak için FilterDetach işlevini çağırır. Daha fazla bilgi için bkz. filtre modülünü ayırma .