OID_SRIOV_RESET_VF
Überlappende Treiber geben eine OID-Set-Anforderung (Object Identifier) von OID_SRIOV_RESET_VF aus, um eine angegebene VIRTUELLE FUNKTION (PCI Express, PCIe) für einen Netzwerkadapter zurückzusetzen, der die Einzelstamm-E/A-Virtualisierung unterstützt. Überlastende Treiber stellen diese OID-Set-Anforderung an den Miniporttreiber des 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 übergeordnete Treiber gibt den Bezeichner des VF an, der über den VFId-Member dieser Struktur zurückgesetzt werden soll.
Bemerkungen
Ein VF kann durch eine 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 übergeordneten Hyper-V-Partition ausgeführt wird. Überlastete Treiber, die im Verwaltungsbetriebssystem ausgeführt werden, werden über die FLR-Anforderung benachrichtigt und stellen die OID-Set-Anforderung von OID_SRIOV_RESET_VF an den PF-Miniporttreiber aus.
Wenn er diese OID-Anforderung verarbeitet, muss der PF-Miniporttreiber die folgenden Richtlinien befolgen:
Der PF-Miniporttreiber muss überprüfen, ob der VF, der vom VFId-Member der NDIS_SRIOV_RESET_VF_PARAMETERS-Struktur angegeben wird, über zuvor zugeordnete Ressourcen verfügt. Der PF-Miniporttreiber ordnet Ressourcen für eine VF während einer OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF zu. 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 sich nicht auf andere VFs oder die PF auf demselben Netzwerkadapter auswirken.
Weitere Informationen finden Sie unter Zurücksetzen einer virtuellen Funktion.
Zurückgeben von Statuscodes
Der PF-Miniporttreiber gibt einen der folgenden status Codes 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 entweder nicht die SR-IOV-Schnittstelle (Single Root E/O Virtualization) oder ist für die Verwendung der Schnittstelle nicht aktiviert. |
NDIS_STATUS_INVALID_PARAMETER |
Mindestens ein Member der NDIS_SRIOV_RESET_VF_PARAMETERS-Struktur weisen ungültige Werte auf. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. Der PF-Miniporttreiber muss die DATEN festlegen. SET_INFORMATION. BytesNeeded-Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße. |
NDIS_STATUS_FAILURE |
Die Anforderung ist aus anderen Gründen fehlgeschlagen. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |