OID_NIC_SWITCH_DELETE_VPORT

Artikel
06/15/2023

Ein überlastende Treiber gibt eine OID-Set-Anforderung (Object Identifier) von OID_NIC_SWITCH_DELETE_VPORT aus, um einen nicht standardmäßigen virtuellen Port (VPort) zu löschen, der zuvor auf dem NIC-Switch eines Netzwerkadapters erstellt wurde. Der überlastende Treiber kann einen zuvor erstellten VPort nur löschen, indem er eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT ausgibt.

Ü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 die NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS-Struktur .

Bemerkungen

Ein überlastender Treiber, z. B. ein Protokoll oder Filtertreiber, kann nur einen nicht standardmäßigen VPort löschen, den er zuvor erstellt hat. Der überlastende Treiber erstellt einen VPort, indem er eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT ausgibt.

Wenn der PF-Miniporttreiber die OID-Anforderung von OID_NIC_SWITCH_DELETE_VPORT empfängt, muss der Treiber die Hardware- und Softwareressourcen freigeben, die für den angegebenen VPort zugewiesen wurden.

Weitere Informationen finden Sie unter Löschen eines virtuellen Ports.

Hinweis Nur nicht standardmäßige VPorts können explizit durch OID-Anforderungen von OID_NIC_SWITCH_DELETE_VPORT gelöscht werden. Der Standard-VPort wird implizit gelöscht, wenn der PF-Miniporttreiber den Standard-NIC-Switch löscht. Weitere Informationen finden Sie unter Löschen eines NIC-Switches.

Rückgabestatuscodes

Der PF-Miniporttreiber gibt einen der folgenden status-Codes für die OID-Set-Anforderung von OID_NIC_SWITCH_DELETE_VPORT zurück.

Statuscode	BESCHREIBUNG
NDIS_STATUS_SUCCESS	Die OID-Anforderung wurde erfolgreich abgeschlossen.
NDIS_STATUS_NOT_SUPPORTED	Der PF-Miniporttreiber unterstützt entweder nicht die SR-IOV-Schnittstelle (Single Root E/O Virtualization) oder ist für die Verwendung der Schnittstelle nicht aktiviert.
NDIS_STATUS_INVALID_PARAMETER	Mindestens ein Member der NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS-Struktur weisen ungültige Werte auf.
NDIS_STATUS_INVALID_LENGTH	Die Länge des Informationspuffers ist kleiner als sizeof(NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS). Der PF-Miniporttreiber muss die DATA festlegen. SET_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_FAILURE	Die Anforderung ist aus anderen Gründen fehlgeschlagen.