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