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 查詢要求，並傳回下列狀態碼。

規格需求

另請參閱

DereferenceSwitchPort

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS

NdisFOidRequest

查詢 Hyper-V 可延伸交換器組態

ReferenceSwitchPort