OID_SWITCH_PORT_PROPERTY_ENUM

Hyper-V 可延伸交換器擴充功能會發出物件識別碼， (OID) 方法要求OID_SWITCH_PORT_PROPERTY_ENUM以取得陣列。此陣列包含符合指定準則的布建埠原則。陣列中的每個元素都會為指定的可延伸交換器埠指定原則的屬性。

NDIS_OID_REQUEST結構的InformationBuffer成員包含緩衝區的指標。此緩衝區包含下列資料：

指定指定埠原則列舉參數的 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 結構。
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO結構的陣列。每個結構都包含可延伸交換器埠原則屬性的相關資訊。

注意如果NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS結構的NumProperties成員設定為零，則不會傳回任何NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO結構。

備註

在發出 OID_SWITCH_PORT_PROPERTY_ENUM 的 OID 方法要求之前，可延伸交換器擴充功能必須遵循下列指導方針：

擴充功能只能在可延伸交換器的通訊協定邊緣發出 OID_SWITCH_PORT_CREATE 要求之後，以及在發出OID_SWITCH_PORT_TEARDOWN要求之前發出 OID_SWITCH_PORT_PROPERTY_ENUM 要求。
擴充功能必須先呼叫 ReferenceSwitchPort ，才能呼叫 NdisFOidRequest 以發出OID_SWITCH_PORT_PROPERTY_ENUM要求。這可確保在 OID 要求完成之前，將不會刪除指定的埠。

完成 OID 要求之後，延伸模組必須呼叫 DereferenceSwitchPort。不論 OID 要求是否已使用 NDIS_STATUS_SUCCESS 完成，擴充功能都必須呼叫此函式。

只有在 Hyper-V 可延伸交換器完成啟用時，才能發出OID_SWITCH_PORT_PROPERTY_ENUM OID。如需詳細資訊，請參閱查詢 Hyper-V 可延伸交換器組態。

注意如果擴充功能收到 OID_SWITCH_PORT_PROPERTY_ENUM 的 OID 方法要求，則它不得完成 OID 要求。相反地，它必須呼叫 NdisFOidRequest ，將 OID 要求轉送至可延伸交換器驅動程式堆疊。

可延伸交換器的基礎迷你埠邊緣會完成OID_SWITCH_PORT_PROPERTY_ENUM的 OID 查詢要求，並傳回下列狀態碼。

狀態碼	描述
NDIS_STATUS_SUCCESS	OID 要求已順利完成。

版本	NDIS 6.30 和更新版本支援。
標頭	Ntddndis.h (包含 Ndis.h)