OID_NIC_SWITCH_FREE_VF

Ein überlastende Treiber stellt eine Objektbezeichner-Set-Anforderung (OID) von OID_NIC_SWITCH_FREE_VF aus, um die Ressourcen für die PCI Express (PCIe) Virtual Function (VF) eines Netzwerkadapters freizugeben.

Überlastende Treiber stellen diese OID-Set-Anforderung an den Miniporttreiber für die PCIe Physical Function (PF) des Netzwerkadapters aus. Diese Anforderung für den OID-Satz ist für PF-Miniporttreiber erforderlich, die die SINGLE-Root-E/A-Virtualisierungsschnittstelle (SR-IOV) unterstützen.

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_NIC_SWITCH_FREE_VF_PARAMETERS-Struktur .

Der überlängte Treiber gibt den Bezeichner des VF an, der über das VFId-Element dieser Struktur freigegeben werden soll. Der Treiber hat diesen Bezeichner aus einer früheren OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF abgerufen.

Bemerkungen

Ein überlastender Treiber gibt eine OID-Set-Anforderung von OID_NIC_SWITCH_FREE_VF aus, um die Ressourcen für eine VF freizugeben. Diese Ressourcen wurden zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF zugeordnet.

Weitere Informationen zum Freigeben von VF-Ressourcen finden Sie unter Freigeben von Ressourcen für eine virtuelle Funktion.

Hinweis Sobald ein überlastender Treiber die Ressourcenzuordnung für eine VF anfordert, ist dieser Treiber die einzige Komponente, die die Freigabe der Ressourcen für dieselbe VF anfordern kann. Der überlastende Treiber muss eine OID-Set-Anforderung von OID_NIC_SWITCH_FREE_VF ausstellen, um die VF-Ressourcen freizugeben. Bevor der überlastende Treiber angehalten werden kann, müssen die Ressourcen für jeden VF freigegeben werden, der durch die OID_NIC_SWITCH_ALLOCATE_VF Anforderung des Fahrers zugewiesen wurde.

Zurückgeben status Codes

Die MiniportOidRequest-Funktion des Miniporttreibers gibt einen der folgenden Werte für diese Anforderung zurück:

Begriff BESCHREIBUNG

NDIS_STATUS_SUCCESS

Der Miniporttreiber hat die Anforderung erfolgreich abgeschlossen.

NDIS_STATUS_PENDING

Der Miniporttreiber führt die Anforderung asynchron aus. Nachdem der Miniporttreiber die gesamte Verarbeitung abgeschlossen hat, muss er die Anforderung erfolgreich ausführen, indem er die NdisMOidRequestComplete-Funktion aufruft und NDIS_STATUS_SUCCESS für den Status-Parameter übergibt.

NDIS_STATUS_NOT_ACCEPTED

Der Miniporttreiber wird zurückgesetzt.

NDIS_STATUS_REQUEST_ABORTED

Der Miniporttreiber hat die Verarbeitung der Anforderung beendet. Beispielsweise hat NDIS die MiniportResetEx-Funktion aufgerufen.

NDIS gibt einen der folgenden status Codes für diese Anforderung zurück:

Begriff BESCHREIBUNG

NDIS_STATUS_SUCCESS

Die OID-Anforderung wurde erfolgreich abgeschlossen.

NDIS_STATUS_NOT_SUPPORTED

Der PF-Miniporttreiber unterstützt entweder die SR-IOV-Schnittstelle nicht oder ist für die Verwendung der Schnittstelle nicht aktiviert.

NDIS_STATUS_FILE_NOT_FOUND

Mindestens ein Member der NDIS_NIC_SWITCH_FREE_VF_PARAMETERS-Struktur weisen ungültige Werte auf. Beispielsweise kann der VFId-Member eine VF angeben, die entweder nicht zugewiesen wurde oder über VPorts verfügt, die nicht gelöscht wurden.

NDIS_STATUS_INVALID_LENGTH

Der Informationspuffer ist zu klein. NDIS legt die DATEN fest. SET_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße.

Requirements (Anforderungen)

Version

Unterstützt in NDIS 6.30 und höher.

Header

Ntddndis.h (include Ndis.h)

Weitere Informationen


NDIS_NIC_SWITCH_FREE_VF_PARAMETERS

NDIS_OID_REQUEST

NdisCloseAdapterEx

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_DELETE_VPORT

OID_NIC_SWITCH_DELETE_SWITCH