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_VFS aus, um ein Array abzurufen. Jedes Element im Array gibt die Attribute eines PCI Express (PCIe) Virtual Function (VF) an, die an einen NIC-Switch auf dem NIC-Switch eines Netzwerkadapters angeschlossen sind.
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_VF_INFO_ARRAY Struktur, die die Anzahl der Elemente innerhalb des Arrays definiert.
Ein Array von NDIS_NIC_SWITCH_VF_INFO Strukturen. Jede dieser Strukturen enthält Informationen zu einem einzelnen VF auf einem NIC-Switch des Netzwerkadapters. Ein VF ist an einen NIC-Schalter über OID-Methodenanforderungen von OID_NIC_SWITCH_ALLOCATE_VFangefügt.
Hinweis Wenn keine VFs an einen NIC-Switch auf dem Netzwerkadapter angefügt sind, wird das NumElements Member der NDIS_NIC_SWITCH_VF_INFO_ARRAY-Struktur auf Null festgelegt, und es werden keine NDIS_NIC_SWITCH_VF_INFO Strukturen zurückgegeben.
Bemerkungen
Beim Überlisten von Treibern und Anwendungen im Benutzermodus werden OID-Methodenanforderungen von OID_NIC_SWITCH_ENUM_VFS zum Aufzählen der VFs ausgeführt, die an den NIC-Switch eines Netzwerkadapters angefügt sind.
Bevor der Treiber oder die Anwendung die OID-Anforderung ausgibt, muss sie eine NDIS_NIC_SWITCH_VF_INFO_ARRAY Struktur initialisieren, die zusammen mit der Anforderung übergeben wird. Der Treiber oder die Anwendung muss beim Initialisieren der NDIS_NIC_SWITCH_VF_INFO_ARRAY-Struktur die folgenden Richtlinien befolgen:
Wenn das NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH Flag im Flags Mitglied festgelegt ist, muss der Treiber oder die Anwendung das SwitchId Mitglied auf den NIC-Switchbezeichner auf dem SR-IOV Netzwerkadapter festlegen. Durch Das Festlegen dieser Member auf diese Weise werden VF-Informationen nur für den angegebenen NIC-Switch auf dem SR-IOV Netzwerkadapter zurückgegeben.
Hinweis Die Überlauftreiber- und Benutzermodusanwendung kann die NIC-Switch-IDs abrufen, indem eine OID-Abfrageanforderung von OID_NIC_SWITCH_ENUM_SWITCHESausgestellt wird.
Wenn das Flags Member auf Null festgelegt ist, muss der Treiber oder die Anwendung das SwitchId Element auf Null festlegen. Durch das Festlegen dieser Member auf diese Weise werden VF-Informationen für alle NIC-Switches auf dem SR-IOV Netzwerkadapter zurückgegeben.
Hinweis Ab Windows Server 2012 unterstützt Windows nur den Standard-NIC-Switch auf dem Netzwerkadapter. Unabhängig von den flags, die im Flags Member festgelegt sind, muss das SwitchId Mitglied auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.
Weitere Informationen zu NIC-Schaltern finden Sie unter NIC Switches.
Rückgabestatuscodes
NDIS behandelt die OID-Methodenanforderung der OID_NIC_SWITCH_ENUM_VFS Anforderung für Miniporttreiber. Die Treiber werden diese OID-Anforderung nicht ausgestellt.
Wenn NDIS die OID_NIC_SWITCH_ENUM_VFS 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) |