Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein übermäßiger Treiber oder eine Benutzermodusanwendung gibt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_ENUM_VPORTS aus, um ein Array abzurufen. Jedes Element im Array gibt die Attribute eines virtuellen Ports (VPort) an, die auf dem NIC-Switch eines Netzwerkadapters erstellt wurden.
Nach einer erfolgreichen Rückgabe dieser OID-Abfrageanforderung enthält das InformationBuffer Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf einen Puffer, der Folgendes enthält:
Eine NDIS_NIC_SWITCH_VPORT_INFO_ARRAY Struktur, die die Anzahl der Elemente innerhalb des Arrays definiert.
Ein Array von NDIS_NIC_SWITCH_VPORT_INFO Strukturen. Jede dieser Strukturen enthält Informationen zu einem VPort auf dem NIC-Switch des Netzwerkadapters.
Hinweis Wenn auf dem Netzwerkadapter keine VPorts erstellt wurden, legt der Treiber das NumElements Member der NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur auf Null fest, und es werden keine NDIS_NIC_SWITCH_VPORT_INFO Strukturen zurückgegeben.
Bemerkungen
Beim Überlisten von Treibern und Anwendungen im Benutzermodus werden OID-Abfrageanforderungen von OID_NIC_SWITCH_ENUM_VPORTS aufgezählt, um die VPorts auflisten, die auf dem NIC-Switch eines Netzwerkadapters zugeordnet sind.
Bevor der Treiber oder die Anwendung die OID-Anforderung ausgibt, muss sie eine NDIS_NIC_SWITCH_VPORT_INFO_ARRAY Struktur initialisieren, die zusammen mit der Anforderung übergeben wird. Der Treiber oder die Anwendung muss beim Initialisieren der NDIS_NIC_SWITCH_VPORT_INFO_ARRAY Struktur die folgenden Richtlinien befolgen:
Wenn das NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH Flag im Flags Member festgelegt ist, werden Informationen für alle VPorts zurückgegeben, die auf einem angegebenen NIC-Switch erstellt wurden. Der NIC-Schalter wird durch das SwitchId-element dieser Struktur angegeben.
Hinweis Ab Windows Server 2012 unterstützt die SR-IOV-Schnittstelle nur den Standard-NIC-Switch auf dem Netzwerkadapter. Unabhängig von den Flags, die im Flags Mitglied festgelegt sind, muss das SwitchId Mitglied auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.
Wenn das NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION Flag im Flags Member festgelegt ist, werden Informationen für alle VPorts zurückgegeben, die an eine angegebene PCI Express (PCIe) Physical Function (PF) oder Virtual Function (VF) auf dem Netzwerkadapter angeschlossen sind. Der PF oder VF wird durch die AttachedFunctionId Member dieser Struktur angegeben.
Wenn die AttachedFunctionId Member auf NDIS_PF_FUNCTION_ID festgelegt ist, werden Informationen für alle VPorts zurückgegeben, einschließlich des Standard-VPorts, die an die PF des Netzwerkadapters angefügt sind. Wenn der AttachedFunctionId Member auf einen gültigen VF-Bezeichner festgelegt ist, werden Informationen für alle VPorts an den angegebenen VF zurückgegeben.
Hinweis Ab Windows Server 2012 kann nur ein nicht standardmäßiger VPort an einen VF angefügt werden. Mehrere VPorts (einschließlich des Standard-VPort) können jedoch an die PF angefügt werden.
Wenn die Flags Member auf Null festgelegt ist, werden Informationen für alle VPorts zurückgegeben, die an den PF oder VF auf dem Netzwerkadapter angefügt sind. In diesem Fall werden die Werte der SwitchId- und AttachedFunctionId- ignoriert.
Weitere Informationen finden Sie unter Aufzählen virtueller Ports auf einem Netzwerkadapter.
Rückgabestatuscodes
NDIS verarbeitet die OID-Methodenanforderung der OID_NIC_SWITCH_ENUM_VPORTS Anforderung für Miniporttreiber. Die Treiber werden diese OID-Anforderung nicht ausgestellt.
Wenn NDIS die OID_NIC_SWITCH_ENUM_VPORTS Anforderung verarbeitet, gibt sie einen der folgenden Statuscodes zurück:
| Statuscode | Beschreibung |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
NDIS_STATUS_NOT_SUPPORTED |
Der 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_VF_INFO_ARRAY-Struktur hat ungültige Werte. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. NDIS legt die DATA fest. METHOD_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) |