OID_SWITCH_PROPERTY_ENUM
Hyper-V 可延伸交換器擴充功能會發出物件識別碼, (OID) 方法要求OID_SWITCH_PROPERTY_ENUM以取得陣列。 此陣列包含符合指定準則的布建交換器原則。 陣列中的每個元素都會指定可延伸交換器原則的屬性。
NDIS_OID_REQUEST結構的InformationBuffer成員包含緩衝區的指標。 此緩衝區包含下列資料:
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS結構,指定可延伸交換器原則列舉的參數。
NDIS_SWITCH_PROPERTY_ENUM_INFO結構的陣列。 每個結構都包含可延伸交換器原則的相關資訊。
注意如果延伸模組尚未布建指定的可延伸交換器原則實例,則擴充功能會將NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS結構的NumProperties成員設定為零,而且不會傳回任何NDIS_SWITCH_PROPERTY_ENUM_INFO結構。
備註
只有在 Hyper-V 可延伸交換器完成啟用時,才能發出OID_SWITCH_PROPERTY_ENUM OID。 如需詳細資訊 ,請參閱查詢 Hyper-V 可延伸交換器組態 。
不同于 OID_SWITCH_PORT_PROPERTY_ENUM的 OID 查詢要求,當擴充功能發出可延伸交換器驅動程式堆疊OID_SWITCH_PROPERTY_ENUM要求時,擴充功能不需要呼叫任何 ReferenceSwitchXxx 或 DereferenceSwitchXxx 函式。
注意 如果擴充功能收到 OID_SWITCH_PROPERTY_ENUM 的 OID 方法要求,則它不得完成 OID 要求。 相反地,它必須呼叫 NdisFOidRequest ,將 OID 要求轉送至可延伸交換器驅動程式堆疊。
傳回狀態碼
可延伸交換器的基礎迷你埠邊緣會完成 OID_SWITCH_PROPERTY_ENUM 的 OID 查詢要求,並傳回下列其中一個狀態碼。
狀態碼 | 描述 |
---|---|
NDIS_STATUS_SUCCESS |
OID 要求已成功完成。 |
NDIS_STATUS_INVALID_LENGTH |
資訊緩衝區的長度太小,無法傳回 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 結構及其 NDIS_SWITCH_PROPERTY_ENUM_INFO 元素的陣列。 可延伸交換器的基礎迷你埠邊緣會設定DATA。METHOD_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員,以達到所需的最小緩衝區大小。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
規格需求
版本 |
NDIS 6.30 和更新版本支援。 |
標頭 |
Ntddndis.h (包括 Ndis.h) |
另請參閱
NDIS_SWITCH_PROPERTY_ENUM_INFO