Connection-Oriented MiniPort Sürücüsünü Sorgulama

Bağlantı yönelimli bir miniport sürücüsünün koruduğu bilgi nesnelerini sorgulamak için, bağlı bir protokol NdisCoOidRequest çağırır ve sorgulanan nesneyi (OID) belirten ve NDIS'nin nihai olarak istenen bilgileri yazdığı bir arabellek sunan bir NDIS_OID_REQUEST yapısı geçirir. NdisCoOidRequest çağrısı, NDIS'nin istenen bilgileri NDIS'ye döndüren miniport sürücüsünün MiniportCoOidRequest işlevini çağırmasına neden olur. MiniportCoOidRequest, NdisCoOidRequestCompleteçağrısıyla senkronize veya asenkronize olarak tamamlanabilir.

NDIS, miniport sürücüsünün özelliklerini, durumunu veya istatistiklerini sorgulamak için miniport sürücüsünün MiniportCoOidRequest işlevini (örneğin miniport sürücüsünün MiniportInitializeEx işlevi NDIS_STATUS_SUCCESS döndürdükten sonra) kendi adına çağırabilir. Aşağıdaki diyagramda bağlantı odaklı bir miniport sürücüsünün sorgulanması gösterilmektedir.

Bağlantı odaklı bir miniport sürücüsünün, belirli bir NIC için tüm sanal bağlantılar (VC) için genel bir temel ve ayrıca VC temelinde bilgi sağlayabilmesi gerekir. Örneğin, OID_GEN_CO_RCV_CRC_ERRORsorgusu için MiniportCoOidRequest'aolmayan bir NULLNdisVcHandle sağlanırsa, miniport sürücüsü belirtilen VC üzerindeki tüm almalarda karşılaşılan CRC hatalarının sayısını döndürür. NULLNdisVcHandleile aynı istek için, miniport sürücüsü, bir NIC üzerinden gelen tüm veriler için karşılaşılan toplam CRC hatası sayısını bildirir.

Aşağıdaki liste, bağlantı odaklı miniport sürücüleri için zorunlu genel işletimsel OID'ler kümesini içerir:

OID_GEN_CO_SUPPORTED_LIST

OID_GEN_CO_HARDWARE_STATUS

OID_GEN_CO_MEDIA_SUPPORTED

OID_GEN_CO_MEDIA_IN_USE

OID_GEN_CO_LINK_SPEED

OID_GEN_CO_VENDOR_ID

OID_GEN_CO_VENDOR_DESCRIPTION

OID_GEN_CO_VENDOR_DRIVER_VERSION

OID_GEN_CO_DRIVER_VERSION

OID_GEN_CO_MAC_OPTIONS

OID_GEN_CO_MEDIA_CONNECT_STATUS

OID_GEN_CO_MINIMUM_LINK_SPEED

Miniport sürücüsünün MiniportCoOidRequest işlevi, önceki tüm OID'lere uygun şekilde sorgulara veya kümelere yanıt vermeye hazır olmalıdır.

MiniportCoOidRequest OID_GEN_CO_MAC_OPTIONS ile çağrıldığında, miniport sürücüsünün gerçekleştirdiği isteğe bağlı işlemleri belirten bir bit maskesi döndürmelidir. Bayrak kümesi şunları içerir:

• NDIS_MAC_OPTION_NO_LOOPBACK. Bu bayrak ayarlanırsa, miniport sürücüsü, aynı bilgisayardaki bir alıcıya yönlendirilen ve miniport sürücüsünün NDIS'nin geri döngü yapmasını beklediği MiniportCoSendNetBufferLists'e geçirilen bir paketi geri döngü yapmaz. NDIS bir paketin geri döngüsünü gerçekleştirirse, paket miniport sürücüsüne geçirilmez. Bir NIC donanım geri döngüleri gerçekleştirmediği sürece miniport sürücüsü her zaman bu bayrağı ayarlar.

• NDIS_MAC_ETOX_INDICATION. Bu bayrak ayarlanırsa, miniport sürücüsü gönderme işleminin ancak NIC paketi aktardıktan sonra tamamlandığını gösterir.

Miniport sürücüsü hiçbir zaman NDIS iç kullanımı için ayrılmış NDIS_MAC_OPTION_RESERVED bayrağını kullanmamalıdır.

MiniportCoOidRequest, NIC'nin geçerli adresini belirlemek için medyaya özgü bir OID ile de sorgulanır.

Daha fazla bilgi için bkz. Connection-Oriented Çağrı Yöneticileri ve İstemcileri için OID'leri ve Genel Nesneler.