OID_SWITCH_PORT_ARRAY

Hyper-V genişletilebilir anahtar uzantısı, dizi almak için OID_SWITCH_PORT_ARRAY nesne tanımlayıcısı (OID) sorgu isteği verir. Dizideki her öğe, genişletilebilir anahtar bağlantı noktası için 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 yönelik bir işaretçi içerir. Bu arabellek aşağıdaki verileri içerir:

• Dizi içindeki öğe sayısını tanımlayan bir NDIS_SWITCH_PORT_ARRAY yapısı.

• NDIS_SWITCH_PORT_PARAMETERS yapıları dizisi. Bu yapıların her biri genişletilebilir anahtardaki bir bağlantı noktası hakkında bilgi içerir.

  Not Genişletilebilir anahtarda hiçbir bağlantı noktası oluşturulmadıysa, sürücü NDIS_SWITCH_PORT_ARRAY yapısının NumElements üyesini sıfır olarak ayarlar ve hiçbir NDIS_SWITCH_PORT_PARAMETERS yapısı döndürülemez.

Açıklamalar

OID_SWITCH_PORT_ARRAY OID yalnızca Hyper-V genişletilebilir anahtarı etkinleştirmeyi tamamladığında verilmesi gerekir. 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_PORT_PARAMETERS yapısını işlediğinde, NDIS_SWITCH_PORT_PARAMETERS yapısının PortNamegibi ç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_PORT_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_PORT_ARRAY ve NDIS_SWITCH_PORT_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_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

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