Aracılığıyla paylaş


OID_SWITCH_NIC_CONNECT

Hyper-V genişletilebilir anahtarın protokol kenarı, genişletilebilir anahtar bağlantı noktası ile ağ bağdaştırıcısı arasında bir ağ bağlantısının tamamen kurulduğunu temel alınan genişletilebilir anahtar uzantılarına bildirmek için OID_SWITCH_NIC_CONNECT nesne tanımlayıcısı (OID) kümesi isteği verir. Protokol kenarı daha önce uzantılara bu bağlantının OID_SWITCH_NIC_CREATEOID kümesi isteği yayımladığında kurulduğunu bildirmişti.

NDIS_OID_REQUEST yapısının InformationBuffer üyesi NDIS_SWITCH_NIC_PARAMETERS bir yapıya yönelik bir işaretçi içerir.

Açıklamalar

NDIS_SWITCH_NIC_PARAMETERS yapısının PortId üyesi, bağlantı bildiriminin yapıldığı genişletilebilir anahtar bağlantı noktasını belirtir. Genişletilebilir anahtar uzantısı, bu bağlantı noktası ve diğer genişletilebilir anahtar bağlantı noktaları için parametre bilgilerini aşağıdaki yollarla alabilir:

NDIS_SWITCH_NIC_PARAMETERS yapısının Dizini üyesi, bağlantı bildiriminin yapıldığı ağ bağdaştırıcısının dizinini belirtir. Belirtilen Index değerine sahip ağ bağdaştırıcısı, PortId üyesi tarafından belirtilen genişletilebilir anahtar bağlantı noktasına bağlanır. Bu dizin değerleri hakkında daha fazla bilgi için bkz. Ağ Bağdaştırıcısı Dizin Değerleri.

OID_SWITCH_NIC_CONNECT OID kümesi isteğini aldığında uzantının şu yönergeleri izlemesi gerekir:

  • OID_SWITCH_NIC_CONNECT isteği NDIS_STATUS_SUCCESS tamamlandığında, ağ bağlantısı ve genişletilebilir anahtar bağlantı noktası tamamen çalışır durumdadır. Uzantı paket trafiği oluşturabilir veya bağlantı noktasının ağ bağlantısına iletebilir. Uzantı, kaynak bağlantı noktası olarak bağlantı noktasını kullanan genişletilebilir anahtar OID'leri veya durum göstergeleri de verebilir. Uzantı, bağlantı noktası için genişletilebilir anahtar başvuru sayacını artırmak için ReferenceSwitchPort da çağırabilir.

  • Uzantı, OID isteğiyle ilişkili NDIS_SWITCH_NIC_PARAMETERS yapısını değiştirmemelidir.

  • Uzantı, bu OID isteğini temel alınan uzantılara iletmek için her zaman NdisFOidRequest çağırmalıdır. Uzantı, OID isteğinin kendisini tamamlamamalıdır.

  • Genişletilebilir anahtar dış ağ bağdaştırıcısı, temel alınan bir veya daha fazla fiziksel bağdaştırıcıya bağlanabilir. Dış ağ bağdaştırıcısına bağlı her fiziksel ağ bağdaştırıcısı için, genişletilebilir anahtarın protokol kenarı ayrı bir OID kümesi isteği OID_SWITCH_NIC_CONNECT. Her OID kümesi isteği farklı bir ağ bağdaştırıcısı bağlantı dizini değeri belirtir. Bu değerler hakkında daha fazla bilgi için bkz. Ağ Bağdaştırıcısı Dizin Değerleri.

    Uzantının, dış ağ bağdaştırıcısına bağlı her temel fiziksel bağdaştırıcı için bağlantı durumunu koruması gerekir. Fiziksel ağ bağdaştırıcılarının dış ağ bağdaştırıcısına bağlanabileceği farklı yapılandırmalar hakkında daha fazla bilgi için bkz. Fiziksel Ağ Bağdaştırıcısı Yapılandırma türleri.

Not Uzantı kendi OID_SWITCH_NIC_CONNECT OID kümesi isteklerini vermemelidir.

Genişletilebilir anahtar bağlantı noktalarının ve ağ bağdaştırıcısı bağlantılarının durumları hakkında daha fazla bilgi için bkz. Hyper-V Genişletilebilir Anahtar Bağlantı Noktası ve Ağ Bağdaştırıcısı Durumları.

İade Durum Kodları

Genişletilebilir anahtarın temel alınan miniport kenarı, OID_SWITCH_NIC_CONNECT OID kümesi isteğini tamamlar ve aşağıdaki durum kodunu döndürür.

Durum Kodu Açıklama

NDIS_STATUS_SUCCESS

OID isteği başarıyla tamamlandı.

Gereksinim -leri

Sürüm

NDIS 6.30 ve sonraki sürümlerde desteklenir.

Üstbilgi

Ntddndis.h (Ndis.h içerir)

Ayrıca bkz.


NdisFReturnNetBufferLists

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_CREATE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort