OID_SWITCH_PORT_ARRAY
Hyper-V 可延伸交換器擴充功能會發出物件識別碼， (OID) 查詢要求OID_SWITCH_PORT_ARRAY以取得陣列。 陣列中的每個元素都會指定可延伸交換器埠的組態參數。
如果 OID 查詢要求順利完成，NDIS_OID_REQUEST結構的InformationBuffer成員會包含緩衝區的指標。 此緩衝區包含下列資料：
定義陣列內元素數目 的NDIS_SWITCH_PORT_ARRAY 結構。
NDIS_SWITCH_PORT_PARAMETERS結構的陣列。 每個結構都包含可延伸交換器上的埠相關資訊。
注意如果未在可延伸交換器上建立任何埠，驅動程式會將NDIS_SWITCH_PORT_ARRAY結構的NumElements成員設定為零，而且不會傳回任何NDIS_SWITCH_PORT_PARAMETERS結構。
備註
只有在 Hyper-V 可延伸交換器完成啟用時，才能發出OID_SWITCH_PORT_ARRAY OID。 如需詳細資訊 ，請參閱查詢 Hyper-V 可延伸交換器組態 。
當延伸模組處理傳回 的 NDIS_SWITCH_PORT_PARAMETERS 結構時，它不得假設 NDIS_SWITCH_PORT_PARAMETERS 結構的各種字串成員，例如 PortName會以 Null 終止。 這些字串成員的資料類型是由 IF_COUNTED_STRING 結構所定義。 驅動程式必須從這個 結構的 Length 成員值判斷字串長度。
注意 如果字串為 Null 終止， Length 成員不得包含終止的 Null 字元。
傳回狀態碼
可延伸交換器的基礎迷你埠邊緣會完成OID_SWITCH_PORT_ARRAY的 OID 查詢要求，並傳回下列其中一個狀態碼。
| 狀態碼 | 描述 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求已順利完成。 |
NDIS_STATUS_INVALID_LENGTH |
資訊緩衝區的長度太小，無法傳回 NDIS_SWITCH_PORT_ARRAY 及其 NDIS_SWITCH_PORT_PARAMETERS 元素陣列。 可延伸交換器的基礎迷你埠邊緣會設定DATA。QUERY_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，到所需的緩衝區大小下限。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
規格需求
版本 |
NDIS 6.30 和更新版本支援。 |
標頭 |
Ntddndis.h (包含 Ndis.h) |