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) |