OID_SWITCH_PROPERTY_ENUM
Hyper-V 可延伸交換器擴充功能會發出OID_SWITCH_PROPERTY_ENUM的對象標識碼 (OID) 方法要求,以取得數位。 此陣列包含符合指定準則的布建交換器原則。 陣列中的每個元素都會指定可延伸交換器原則的屬性。
InformationBufferNDIS_OID_REQUEST 結構的成員包含緩衝區的指標。 此緩衝區包含下列資料:
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 結構,指定可延伸交換器原則列舉的參數。
NDIS_SWITCH_PROPERTY_ENUM_INFO 結構的陣列。 每個結構都包含可延伸交換器原則的相關信息。
注意 如果延伸模組尚未布建指定可延伸交換器原則的實例,擴充功能會將 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 結構 成員的 NumProperties 設定為零,而且不會傳回任何 NDIS_SWITCH_PROPERTY_ENUM_INFO 結構。
言論
OID_SWITCH_PROPERTY_ENUM OID 只能在 Hyper-V 可延伸交換器完成啟用時發出。 如需詳細資訊,請參閱 查詢 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。BytesNeededNDIS_OID_REQUEST 結構中的成員,以所需的緩衝區大小下限。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
要求
版本 |
NDIS 6.30 和更新版本支援。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |
另請參閱
NDIS_SWITCH_PROPERTY_ENUM_INFO