OID_NIC_SWITCH_DELETE_VPORT
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. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |