OID_NIC_SWITCH_FREE_VF
Ein übermäßiger Treiber gibt eine OID-Setanforderung (Object Identifier) von OID_NIC_SWITCH_FREE_VF aus, um die Ressourcen für die PCI Express (PCIe) Virtual Function (VF) eines Netzwerkadapters freizugeben.
Überlying drivers issue this OID set request to the miniport driver for the network adapter's PCIe Physical Function (PF). Diese OID-Setanforderung ist für PF-Miniporttreiber erforderlich, die die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) unterstützen.
Das InformationBuffer Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_NIC_SWITCH_FREE_VF_PARAMETERS Struktur.
Der Überlauftreiber gibt den Bezeichner des VF an, der über die VFId Mitglied dieser Struktur freigegeben werden soll. Der Treiber hat diesen Bezeichner aus einer früheren OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VFabgerufen.
Bemerkungen
Ein übermäßiger Treiber gibt eine OID-Satzanforderung von OID_NIC_SWITCH_FREE_VF aus, um die Ressourcen für einen VF freizugeben. Diese Ressourcen wurden zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VFzugeordnet.
Weitere Informationen zum Freigeben von VF-Ressourcen finden Sie unter Freigeben von Ressourcen für eine virtuelle Funktion.
Hinweis Sobald ein übermäßiger Treiber die Ressourcenzuordnung für einen VF anfordert, ist dieser Treiber die einzige Komponente, die die Freisetzung der Ressourcen für denselben VF anfordern kann. Der überlagernde Treiber muss eine OID-Satzanforderung von OID_NIC_SWITCH_FREE_VF ausstellen, um die VF-Ressourcen freizugeben. Bevor der überlagernde Fahrer angehalten werden kann, muss er die Ressourcen für jeden VF freigeben, der von der OID_NIC_SWITCH_ALLOCATE_VF Anforderung des Fahrers zugewiesen wurde.
Rückgabestatuscodes
Die MiniportOidRequest Funktion des Miniporttreibers gibt einen der folgenden Werte für diese Anforderung zurück:
| Ausdruck | 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 die Anforderung erfolgreich ausgeführt werden, indem die NdisMOidRequestComplete--Funktion aufgerufen wird und NDIS_STATUS_SUCCESS für den parameter Status übergeben wird. |
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 funktion MiniportResetEx aufgerufen. |
NDIS gibt einen der folgenden Statuscodes für diese Anforderung zurück:
| Ausdruck | Beschreibung |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
NDIS_STATUS_NOT_SUPPORTED |
Der PF-Miniporttreiber unterstützt weder die SR-IOV Schnittstelle noch ist die Verwendung der Schnittstelle aktiviert. |
NDIS_STATUS_FILE_NOT_FOUND |
Mindestens ein Element der NDIS_NIC_SWITCH_FREE_VF_PARAMETERS-Struktur hat ungültige Werte. Beispielsweise kann das VFId- Mitglied einen VF angeben, der 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 DATA fest. SET_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße. |
Anforderungen
Version |
Unterstützt in NDIS 6.30 und höher. |
Kopfball |
Ntddndis.h (include Ndis.h) |