Freigeben über


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)

Siehe auch


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