OID_SWITCH_NIC_ARRAY

Hyper-V genişletilebilir anahtar uzantısı, dizi almak için OID_SWITCH_NIC_ARRAY nesne tanımlayıcısı (OID) sorgu isteği verir. Dizideki her öğe, genişletilebilir anahtar bağlantı noktasıyla ilişkili bir sanal ağ bağdaştırıcısının yapılandırma parametrelerini belirtir.

OID sorgu isteği başarıyla tamamlanırsa, NDIS_OID_REQUEST yapısının InformationBuffer üyesi arabelleğe bir işaretçi içerir. Bu arabellek aşağıdaki verileri içerir:

• Dizideki öğe sayısını tanımlayan bir NDIS_SWITCH_NIC_ARRAY yapısı. Bu yapı, dizideki ilk öğeye uzaklığı da belirtir.

• NDIS_SWITCH_NIC_PARAMETERS yapıları dizisi. Bu yapıların her biri genişletilebilir anahtar bağlantı noktasına bağlı bir ağ bağdaştırıcısı hakkında bilgi içerir.

  Not Genişletilebilir anahtar bağlantı noktalarına hiçbir ağ bağdaştırıcısı bağlı değilse, genişletilebilir anahtarın temel alınan miniport kenarı, NDIS_SWITCH_NIC_ARRAY yapısının NumElements üyesini sıfır olarak ayarlar. Bu durumda, hiçbir NDIS_SWITCH_NIC_PARAMETERS yapı döndürülür.

Açıklamalar

OID_SWITCH_NIC_ARRAY OID yalnızca Hyper-V genişletilebilir anahtar etkinleştirmeyi tamamladığında yapılmalıdır. Daha fazla bilgi için lütfen Hyper-V Genişletilebilir Anahtar Yapılandırması sorgulama bölümüne bakın.

Uzantı döndürülen NDIS_SWITCH_NIC_PARAMETERS yapısını işlediğinde, NDIS_SWITCH_PORT_PARAMETERS yapısının NicFriendlyNamegibi çeşitli dize üyelerinin NULL sonlandırıldığını varsaymamalıdır. Bu dize üyeleri için veri türleri, IF_COUNTED_STRING yapısı tarafından tür tanımlıdır. Sürücü, bu yapının Uzunluğu üyesinin değerinden dize uzunluğunu belirlemelidir.

Not Dize null olarak sonlandırıldıysa, Uzunluğu üyesi sonlandırıcı null karakteri içermemelidir.

İade Durum Kodları

Genişletilebilir anahtarın temel alınan miniport kenarı, OID_SWITCH_NIC_ARRAY OID sorgu isteğini tamamlar ve aşağıdaki durum kodlarından birini döndürür.

Durum Kodu	Açıklama
NDIS_STATUS_SUCCESS	OID isteği başarıyla tamamlandı.
NDIS_STATUS_INVALID_LENGTH	Bilgi arabelleğinin uzunluğu, NDIS_SWITCH_NIC_ARRAY ve NDIS_SWITCH_NIC_PARAMETERS öğe dizisini döndürmek için çok küçük. Genişletilebilir anahtarın temel alınan miniport kenarı, DATA'yi ayarlar. QUERY_INFORMATION. BytesNeeded üyesi NDIS_OID_REQUEST yapısında gereken en düşük arabellek boyutuna.
NDIS_STATUS_FAILURE	İstek başka nedenlerle başarısız oldu.

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_ARRAY

NDIS_SWITCH_NIC_PARAMETERS

Hyper-V Genişletilebilir Anahtar Yapılandırması Sorgulamayı