管理自訂埠功能狀態資訊

Hyper-V 可延伸交換器介面會使用下列物件識別碼 (OID) 來查詢可延伸交換器埠的自訂狀態資訊。 此狀態資訊稱為 埠功能狀態 資訊：

OID_SWITCH_PORT_FEATURE_STATUS_QUERY
這個 OID 方法要求是由可延伸交換器的通訊協定邊緣發出，以取得指定埠屬性的自訂功能狀態資訊。

從這個 OID 方法要求成功傳回之後，NDIS_OID_REQUEST結構的InformationBuffer成員會包含緩衝區的指標。 此緩衝區包含下列資料：

• NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS結構，指定要傳回的自訂功能狀態資訊。

  注意 針對自訂功能狀態， FeatureStatusType 成員會設定為 NdisSwitchPortPropertyTypeCustom。

• NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM結構，其中包含指派給可延伸交換器埠之自訂屬性的狀態資訊。

  當可延伸交換器的通訊協定邊緣發出 OID_SWITCH_PORT_FEATURE_STATUS_QUERY 要求時，它會將 FeatureStatusCustomBufferLength 和 FeatureStatusCustomBufferOffset 成員設定為 InformationBuffer 成員中可用來傳回功能狀態資訊的位置。

當可延伸交換器擴充功能收到 OID_SWITCH_PORT_FEATURE_STATUS_QUERY的 OID 方法要求時，必須遵循下列指導方針：

• 如果擴充功能管理符合NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS結構的FeatureStatusId成員的自訂可延伸交換器埠屬性，則必須處理 OID 要求。

• 如果延伸模組處理 OID 方法要求，它必須傳回符合 NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 結構所指定參數的功能狀態資訊。

  如果功能狀態緩衝區太小，擴充功能必須讓 OID 要求失敗，並NDIS_STATUS_INVALID_LENGTH。 延伸模組必須設定DATA。SET_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，以達到所需的最小緩衝區大小。

  否則，延伸模組必須傳回功能狀態資訊，並使用 NDIS_STATUS_SUCCESS完成 OID 要求。

• 如果擴充功能未管理自訂可延伸交換器屬性，則必須呼叫 NdisFOidRequest ，將 OID 要求轉送至可延伸交換器驅動程式堆疊。

  如需如何轉送 OID 要求的詳細資訊，請參閱 篩選 NDIS 篩選驅動程式中的 OID 要求。

如需如何定義和註冊埠功能狀態資訊的詳細資訊，請參閱 自訂埠功能狀態。