OID_NIC_SWITCH_DELETE_SWITCH

Artikel
06/15/2023

NDIS gibt eine OID-Set-Anforderung (Object Identifier) von OID_NIC_SWITCH_DELETE_SWITCH aus, um einen NIC-Switch von einem Netzwerkadapter zu löschen.

NDIS gibt diese OID-Set-Anforderung an den Miniporttreiber des PCI Express (PCIe) Physical Function (PF) des Netzwerkadapters aus. Diese OID-Set-Anforderung ist für PF-Miniporttreiber erforderlich, die die SR-IOV-Schnittstelle (Single Root I/O Virtualization) unterstützen.

Hinweis Überlastende Treiber, z. B. Protokoll- oder Filtertreiber, können diese OID-Methodenanforderung nicht an den PF-Miniporttreiber ausgeben.

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

Bemerkungen

Eine OID-Set-Anforderung von OID_NIC_SWITCH_DELETE_SWITCH löscht einen NIC-Switch, der zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCH erstellt wurde.

Wenn er die OID-Methodenanforderung von OID_NIC_SWITCH_DELETE_SWITCH empfängt, muss der PF-Miniporttreiber die folgenden Schritte ausführen:

Wenn der PF-Miniporttreiber die statische Erstellung und Konfiguration von NIC-Switches unterstützt, müssen die Softwareressourcen freigegeben werden, die dem angegebenen NIC-Switch zugeordnet sind. Der Treiber kann die Hardwareressourcen für den NIC-Switch jedoch nur freigeben, wenn MiniportHaltEx aufgerufen wird.

Weitere Informationen zur Erstellung eines statischen NIC-Switches finden Sie unter Statische Erstellung eines NIC-Switches.
Wenn der PF-Miniporttreiber die dynamische Erstellung und Konfiguration von NIC-Switches unterstützt, muss er die Hardware- und Softwareressourcen freigeben, die dem angegebenen NIC-Switch zugeordnet sind.

Weitere Informationen zur Erstellung dynamischer NIC-Switches finden Sie unter Dynamische Erstellung eines NIC-Switches.
Wenn der PF-Miniporttreiber die dynamische Erstellung unterstützt und alle NIC-Switches gelöscht wurden, muss der Treiber die Virtualisierung auf dem Adapter durch Aufrufen von NdisMEnableVirtualization deaktivieren. Um die Virtualisierung zu deaktivieren, muss der Netzwerkadapter den Parameter EnableVirtualization auf FALSE und den NumVFs-Parameter auf Null festlegen.

NdisMEnableVirtualization löscht den NumVFs-Member und das VF Enable-Bit in der SR-IOV Extended Capability-Struktur im PCI-Konfigurationsraum der PF des Netzwerkadapters.

Hinweis Wenn der PF-Miniporttreiber die statische Erstellung und Konfiguration von NIC-Switches unterstützt, darf er nur NdisMEnableVirtualization aufrufen, wenn MiniportHaltEx aufgerufen wird.

Weitere Informationen finden Sie unter Löschen eines NIC-Switches.

Zurückgeben von Statuscodes

Die MiniportOidRequest-Funktion des Miniport-Treibers 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 alle Verarbeitungsschritte abgeschlossen hat, muss er die Anforderung erfolgreich ausführen, indem er die NdisMOidRequestComplete-Funktion aufruft und NDIS_STATUS_SUCCESS für den Parameter Status ü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_DELETE_SWITCH_PARAMETERS-Struktur hat ungültige Werte.
NDIS_STATUS_INVALID_LENGTH	Der Informationspuffer ist zu klein. NDIS legt die DATEN fest. SET_INFORMATION. BytesNeeded-Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.