OID_NIC_SWITCH_FREE_VF

發行項
06/15/2023

過度配置驅動程式會發出物件識別碼 (OID) OID_NIC_SWITCH_FREE_VF的要求，以釋放網路介面卡的 PCI Express (PCIe) Virtual Function (VF) 的資源。

過度處理驅動程式會將此 OID 設定要求傳送給網路介面卡 PCIe 實體函式的迷你埠驅動程式， (PF) 。支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的 PF 迷你埠驅動程式需要此 OID 集合要求。

NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_NIC_SWITCH_FREE_VF_PARAMETERS結構的指標。

過度配置驅動程式會指定要透過這個結構的 VFId 成員釋放的 VF 識別碼。驅動程式從先前的 OID 方法要求取得此識別碼，OID_NIC_SWITCH_ALLOCATE_VF。

備註

過度處理驅動程式會發出 OID 集合OID_NIC_SWITCH_FREE_VF要求，以釋放 VF 的資源。這些資源先前是透過 OID_NIC_SWITCH_ALLOCATE_VF的 OID 方法要求來配置。

如需如何釋放 VF 資源的詳細資訊，請參閱釋放虛擬函式的資源。

注意一旦過度配置驅動程式要求 VF 的資源配置之後，該驅動程式就是唯一可以要求釋放相同 VF 資源的資源的元件。過度處理驅動程式必須發出 OID 集合要求，OID_NIC_SWITCH_FREE_VF以釋放 VF 資源。在過度配置驅動程式停止之前，它必須釋放驅動程式 OID_NIC_SWITCH_ALLOCATE_VF要求所配置之每個 VF 的資源。

傳回狀態碼

miniport 驅動程式的 MiniportOidRequest 函式會針對此要求傳回下列其中一個值：

詞彙	描述
NDIS_STATUS_SUCCESS	迷你埠驅動程式已成功完成要求。
NDIS_STATUS_PENDING	迷你埠驅動程式會以非同步方式完成要求。迷你埠驅動程式完成所有處理之後，它必須藉由呼叫NdisMOidRequestComplete函式來成功要求，並傳遞Status參數的NDIS_STATUS_SUCCESS。
NDIS_STATUS_NOT_ACCEPTED	迷你埠驅動程式已重設。
NDIS_STATUS_REQUEST_ABORTED	迷你埠驅動程式已停止處理要求。例如，NDIS 稱為 MiniportResetEx 函式。

NDIS 會針對此要求傳回下列其中一個狀態碼：

詞彙	描述
NDIS_STATUS_SUCCESS	OID 要求已成功完成。
NDIS_STATUS_NOT_SUPPORTED	PF 迷你埠驅動程式不支援 SR-IOV 介面，或未啟用該介面。
NDIS_STATUS_FILE_NOT_FOUND	NDIS_NIC_SWITCH_FREE_VF_PARAMETERS結構的一或多個成員具有不正確值。例如， VFId 成員可能會指定未配置或 VPorts 尚未刪除的 VF。
NDIS_STATUS_INVALID_LENGTH	資訊緩衝區太小。 NDIS 會設定DATA。SET_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，以達到所需的最小緩衝區大小。