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