Freigeben über


OID_NIC_SWITCH_DELETE_VPORT

Ein übermäßiger Treiber gibt eine OID-Setanforderung (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 VPort löschen, den er zuvor erstellt hat, indem er eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORTausgibt.

Ü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-element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf die NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS-Struktur.

Bemerkungen

Ein übermäßiger 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 eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORTausgestellt wird.

Wenn der PF Miniport-Treiber 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 über 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-Schalters.

Rückgabestatuscodes

Der PF Miniport-Treiber gibt einen der folgenden Statuscodes für die OID-Setanforderung 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 weder die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) noch ist die Verwendung der Schnittstelle aktiviert.

NDIS_STATUS_INVALID_PARAMETER

Mindestens ein Element der NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS-Struktur hat ungültige Werte.

NDIS_STATUS_INVALID_LENGTH

Die Länge des Informationspuffers ist kleiner als die Größe(NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS). Der PF-Miniporttreiber muss die DATA festlegen. SET_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_FAILURE

Fehler bei der Anforderung aus anderen Gründen.

Anforderungen

Version

Unterstützt in NDIS 6.30 und höher.

Kopfball

Ntddndis.h (include Ndis.h)

Siehe auch


NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS

NDIS_OID_REQUEST

NdisCloseAdapterEx

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_DELETE_SWITCH