共用方式為

OID_SRIOV_RESET_VF

  • 發行項

過度處理驅動程式會在支援單一根目錄 I/O 虛擬化的網路介面卡上重設指定的 PCI Express (PCIe) Virtual Function (VF) ， (OID) 設定 OID_SRIOV_RESET_VF要求的物件識別碼。 過度處理驅動程式會將此 OID 設定要求發給 PCI Express (PCIe) 實體函式的迷你埠驅動程式， (網路介面卡的 PF) 。

NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_SRIOV_RESET_VF_PARAMETERS結構的指標。 過度配置驅動程式會指定要透過這個 結構的 VFId 成員重設的 VF 識別碼。

備註

VF 可以透過 PCI Express (PCIe) 函式層級重設 (FLR) 重設。 由於 FLR 要求是特殊許可權的作業，因此只能由在 Hyper-V 父分割區管理作業系統中執行的 PF 迷你埠驅動程式執行。 在管理作業系統中執行的過度驅動程式會收到 FLR 要求的通知，並將 OID_SRIOV_RESET_VF 的 OID 集合要求發出給 PF 迷你埠驅動程式。

當它處理此 OID 要求時，PF 迷你埠驅動程式必須遵循下列指導方針：

  • PF 迷你埠驅動程式必須確認VF 是由NDIS_SRIOV_RESET_VF_PARAMETERS結構的VFId成員所指定的 VF，具有先前已配置的資源。 PF 迷你埠驅動程式會在 OID_NIC_SWITCH_ALLOCATE_VF 的 OID方法要求期間，為 VF 配置資源。 如果尚未配置指定 VF 的資源，驅動程式必須失敗 OID 要求。

  • 重設作業只能影響指定的 VF。 此作業不得影響相同網路介面卡上的其他 VFs 或 PF。

如需詳細資訊，請參閱 重設虛擬函式。

傳回狀態碼

PF 迷你埠驅動程式會針對OID_SRIOV_RESET_VF集要求傳回下列其中一個狀態碼。

狀態碼 描述

NDIS_STATUS_SUCCESS

OID 要求已順利完成。

NDIS_STATUS_NOT_SUPPORTED

PF 迷你埠驅動程式不支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面，或未啟用該介面。

NDIS_STATUS_INVALID_PARAMETER

NDIS_SRIOV_RESET_VF_PARAMETERS結構的一或多個成員具有不正確值。

NDIS_STATUS_INVALID_LENGTH

資訊緩衝區太短。 PF 迷你埠驅動程式必須設定DATA。SET_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，到所需的緩衝區大小下限。

NDIS_STATUS_FAILURE

要求因其他原因而失敗。

規格需求

版本

NDIS 6.30 和更新版本支援。

標頭

 Ntddndis.h (包含 Ndis.h)

另請參閱

NDIS_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF