Freigeben über


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)

Weitere Informationen


NDIS_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF