OID_SWITCH_NIC_CREATE

Hyper-V genişletilebilir anahtarın protokol kenarı, genişletilebilir anahtar bağlantı noktası ile dış veya sanal ağ bağdaştırıcısı arasında yeni bir bağlantı kurulmakta olduğunu temel alınan genişletilebilir anahtar uzantılarına bildirmek için OID_SWITCH_NIC_CREATE nesne tanımlayıcısı (OID) kümesi isteği verir. Bağlantı tamamen kurulduktan sonra, genişletilebilir anahtarın protokol kenarı OID_SWITCH_NIC_CONNECTbir OID kümesi isteği oluşturur.

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, oluşturma bildiriminin yapıldığı genişletilebilir anahtar bağlantı noktasını belirtir. Genişletilebilir anahtar uzantısı, OID_SWITCH_PORT_ARRAYOID sorgu istekleri vererek bu ve genişletilebilir anahtardaki diğer bağlantı noktaları için parametre bilgilerini alabilir.

NDIS_SWITCH_NIC_PARAMETERS yapısının Dizini üyesi, oluşturma 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_CREATE OID kümesi isteğini aldığında uzantının şu yönergeleri izlemesi gerekir:

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

• OID_SWITCH_NIC_CREATE isteği, uzantıya yalnızca yeni bir genişletilebilir anahtar bağlantısının getirildiğini ve bu paket trafiğinin kısa süre içinde belirtilen bağlantı noktası üzerinden gerçekleşmeye başlandığını bildirir. Ancak, genişletilebilir anahtarın protokol kenarı OID_SWITCH_NIC_CONNECTOID kümesi isteği göndermeden uzantı bağlantı noktasını kullanamaz. Bu OID verilene kadar uzantı aşağıdakileri yapmamalıdır:

  • OID_SWITCH_NIC_CREATE OID isteğinin verildiği genişletilebilir anahtar bağlantı noktasında ağ bağdaştırıcısı bağlantısına yönelik paket trafiği oluşturun.

  • OID_SWITCH_NIC_REQUEST OID isteklerini, OID_SWITCH_NIC_CREATE OID isteğinin verildiği temel bir ağ bağdaştırıcısına iletin veya kaynaklanır.

  • OID_SWITCH_NIC_CREATE OID isteğinin verildiği temel bir ağ bağdaştırıcısından NDIS_STATUS_SWITCH_NIC_STATUS NDIS durum göstergelerini ilet veya kaynağı.

  • Genişletilebilir anahtar bağlantı noktasında belirtilen ağ bağdaştırıcısı bağlantısı için genişletilebilir anahtar başvuru sayacını artırmak için ReferenceSwitchNic çağırın.

  Not Uzantı, OID_SWITCH_NIC_CREATE ve OID_SWITCH_NIC_CONNECTOID istekleri arasında belirtilen bağlantı noktası için gönderme veya alma paketlerini kesebilir. Bu durumda uzantı, paket gönderme veya alma isteklerini iptal etmek yerine iletmelidir.

• Uzantı, OID isteği için NDIS_STATUS_DATA_NOT_ACCEPTED döndürerek oluşturma bildirimini veto edebilir. Örneğin, bir uzantı belirtilen bağlantı noktasında yapılandırılmış ilkelerini karşılayamıyorsa, uzantı oluşturma bildirimini veto etmelidir.

  Uzantı xxxdiğer NDIS_STATUS_ durum kodlarını döndürürse, oluşturma bildirimi de veto edilir. Ancak, NDIS_STATUS_RESOURCES döndürme gibi geçici senaryolar için durum kodlarının döndürülmesi, oluşturma bildiriminin yeniden denenmesiyle sonuçlanabilir.

  Uzantı OID isteğini veto etmiyorsa, istek tamamlandığında durumu izlemelidir. Uzantı, OID isteğinin genişletilebilir anahtar denetim yolundaki temel uzantılar veya genişletilebilir anahtar arabirimi tarafından veto edilip edilmediğini belirlemek için bunu yapmalıdır.

  Not Uzantı yalnızca NDIS_SWITCH_NIC_PARAMETERS yapısının Dizini üyesi sıfır ağ bağdaştırıcısı dizin değerini belirtiyorsa OID isteğini veto edebilir.

• Uzantı oluşturma bildirimini veto etmiyorsa, bu OID isteğini genişletilebilir anahtar sürücüsü yığınındaki temel uzantılara iletmek için NdisFOidRequest çağırmalıdır.

  Not Uzantı, bu OID isteğinin tamamlanma durumunu izlemelidir. Uzantı bunu, genişletilebilir anahtar sürücü yığınındaki temel uzantıların oluşturma bildirimini veto edip etmediğini algılamak için yapar.

• Uzantı bu OID isteğini iletmek için NdisFOidRequest çağırırsa, uzantı genişletilebilir anahtar bağlantı noktasına veya bağlantı noktasından hemen paket trafiği almaz. Ayrıca uzantı, genişletilebilir anahtar bağlantı noktası için gönderme veya alma trafiğini hemen ekleyemez.

• Uzantı, paket trafiğini yalnızca genişletilebilir anahtarın protokol kenarı OID_SWITCH_NIC_CONNECTOID kümesi isteği verdikten sonra genişletilebilir anahtar bağlantı noktasına iletebilir.

  Not Bazı durumlarda paket trafiği, OID_SWITCH_NIC_CONNECT OID kümesi isteği verilmeden önce genişletilebilir anahtar tarafından bağlantı noktasına iletilebilir.

• 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_CREATE. Her OID kümesi isteği farklı bir ağ bağdaştırıcısı bağlantı dizini değeri belirtir. Bu dizin değerleri hakkında daha fazla bilgi için bkz. Ağ Bağdaştırıcısı Dizin Değerleri.

  Uzantı, temel alınan her fiziksel bağdaştırıcı için bağlantı durumunu korumalıdır. 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.

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ı.

Not Uzantının kendi OID_SWITCH_NIC_CREATE OID kümesi isteklerini vermemesi gerekir.

İade Durum Kodları

Uzantı OID_SWITCH_NIC_CREATE OID kümesi isteğini tamamlarsa aşağıdaki durum kodlarından birini döndürür.

Durum Kodu	Açıklama
NDIS_STATUS_DATA_NOT_ACCEPTED	Uzantı oluşturma bildirimini veto etti.
NDIS_STATUS_RESOURCES	Uzantı, düşük kaynak koşulu nedeniyle oluşturma bildirimini veto etti.
xxxNDIS_STATUS_	Uzantı, oluşturma bildirimini başka nedenlerle veto etti.

Not Uzantı OID kümesi isteğini tamamlarsa NDIS_STATUS_SUCCESS döndürmemelidir.

Uzantı OID_SWITCH_NIC_CREATE OID kümesi isteğini tamamlamazsa, istek genişletilebilir anahtarın temel alınan miniport kenarı tarafından tamamlanır. Temel alınan miniport kenarı, bu OID kümesi isteği için 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.

---

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_CONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort