Freigeben über


OID_SRIOV_RESET_VF

Überlastungstreiber stellen eine OID-Setanforderung (Object Identifier) von OID_SRIOV_RESET_VF aus, um eine angegebene VIRTUELLE PCI Express(PCIe)-Funktion (VF) auf einem Netzwerkadapter zurückzusetzen, der die Einzelstamm-E/A-Virtualisierung unterstützt. Überlying-Treiber geben diese OID-Set-Anforderung an den Miniporttreiber der PCI Express (PCIe) Physical Function (PF) des Netzwerkadapters aus.

Das InformationBuffer Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SRIOV_RESET_VF_PARAMETERS Struktur. Der Überlauftreiber gibt den Bezeichner des VF an, der über die VFId Mitglied dieser Struktur zurückgesetzt werden soll.

Bemerkungen

Ein VF kann über einen PCI Express (PCIe) Function Level Reset (FLR) zurückgesetzt werden. Da die FLR-Anforderung ein privilegierter Vorgang ist, kann sie nur vom PF-Miniporttreiber ausgeführt werden, der im Verwaltungsbetriebssystem einer Hyper-V übergeordneten Partition ausgeführt wird. Overlying drivers that run in the management operating system are notified of the FLR request and issue the OID set request of OID_SRIOV_RESET_VF to the PF miniport driver.

Wenn sie diese OID-Anforderung verarbeitet, muss der PF-Miniporttreiber die folgenden Richtlinien befolgen:

  • Der PF-Miniporttreiber muss überprüfen, ob der VFId, der durch das VFId- Mitglied der NDIS_SRIOV_RESET_VF_PARAMETERS-Struktur angegeben ist, Über Ressourcen verfügt, die zuvor zugeordnet wurden. Der PF Miniport-Treiber weist ressourcen für einen VF während einer OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VFzu. Wenn ressourcen für den angegebenen VF nicht zugeordnet wurden, muss der Treiber die OID-Anforderung nicht ausführen.

  • Der Zurücksetzungsvorgang darf sich nur auf den angegebenen VF auswirken. Der Vorgang darf keine Auswirkungen auf andere VFs oder den PF auf demselben Netzwerkadapter haben.

Weitere Informationen finden Sie unter Zurücksetzen einer virtuellen Funktion.

Rückgabestatuscodes

Der PF-Miniport-Treiber gibt einen der folgenden Statuscodes für die set-Anforderung von OID_SRIOV_RESET_VF zurück.

Statuscode Beschreibung

NDIS_STATUS_SUCCESS

Die OID-Anforderung wurde erfolgreich abgeschlossen.

NDIS_STATUS_NOT_SUPPORTED

Der PF-Miniporttreiber unterstützt weder die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) noch ist die Verwendung der Schnittstelle aktiviert.

NDIS_STATUS_INVALID_PARAMETER

Mindestens ein Element der NDIS_SRIOV_RESET_VF_PARAMETERS-Struktur hat ungültige Werte.

NDIS_STATUS_INVALID_LENGTH

Der Informationspuffer war zu kurz. Der PF-Miniporttreiber muss die DATA festlegen. SET_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_FAILURE

Fehler bei der Anforderung aus anderen Gründen.

Anforderungen

Version

Unterstützt in NDIS 6.30 und höher.

Kopfball

Ntddndis.h (include Ndis.h)

Siehe auch


NDIS_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF