OID_SWITCH_PORT_CREATE

Hyper-V genişletilebilir anahtarın protokol kenarı, genişletilebilir anahtar bağlantı noktası oluşturma hakkında genişletilebilir anahtar uzantılarına bildirim göndermek için OID_SWITCH_PORT_CREATE nesne tanımlayıcısı (OID) kümesi isteği verir.

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

Açıklamalar

NDIS_SWITCH_PORT_PARAMETERS yapısının PortId üyesi, oluşturma bildiriminin yapıldığı bağlantı noktasını belirtir.

Genişletilebilir anahtar uzantısı, OID_SWITCH_PORT_CREATE OID kümesi isteklerini işlemeye yönelik şu yönergeleri izlemelidir:

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

• Uzantı, OID isteği için NDIS_STATUS_DATA_NOT_ACCEPTED döndürerek oluşturma bildirimini veto edebilir. Örneğin, bir uzantı yapılandırılan ilkelerini bağlantı noktasında zorlamak için kaynak ayıramıyorsa, sürücü oluşturma bildirimini veto etmelidir.

  Uzantı xxxdiğer NDIS_STATUS_ hata 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.

  Bağlantı noktası ilkeleri hakkında daha fazla bilgi için bkz. Hyper-V Genişletilebilir Anahtar İlkelerini Yönetme.

• Uzantı, bu OID kümesi isteğini iletmek için NdisFOidRequest çağırırsa, uzantının bu OID isteğinin tamamlanma durumunu izlemesi gerekir. Uzantı bunu, genişletilebilir anahtar sürücü yığınındaki temel uzantıların bağlantı noktası oluşturma bildirimini veto edip etmediğini algılamak için yapar.

• OID isteği iletildikten ve başarıyla tamamlandıktan sonra uzantı, OID_SWITCH_PORT_TEARDOWN OID isteği verilene kadar bağlantı noktası için OID_SWITCH_PORT_PROPERTY_ENUMgibi OID istekleri verebilir. Bu OID isteği uzantıya bağlantı noktasının genişletilebilir anahtardan silme işlemini başlatacağını bildirir.

• Uzantılar, OID_SWITCH_NIC_CONNECT OID kümesi isteği verilip başarıyla tamamlanana kadar paketleri NDIS_SWITCH_PORT_PARAMETERS yapısında belirtilen bağlantı noktasına iletemez.

Not Uzantıları, OID_SWITCH_PORT_CREATE 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ı

Uzantı OID_SWITCH_PORT_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_PORT_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_PORT_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_CONNECT

OID_SWITCH_PORT_ARRAY

OID_SWITCH_PORT_PROPERTY_ENUM