OID_NIC_SWITCH_ENUM_VFS
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 einer PCI Express (PCIe) Virtual Function (VF) an, die an einen NIC-Switch eines Netzwerkadapters angefügt sind.
Nach einer erfolgreichen Rückgabe dieser OID-Abfrageanforderung enthält der InformationBuffer-Member 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 wird über OID-Methodenanforderungen von OID_NIC_SWITCH_ALLOCATE_VF an einen NIC-Switch angefügt.
Hinweis Wenn keine VFs an einen NIC-Switch auf dem Netzwerkadapter angefügt sind, wird der 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
Überlastende Treiber und Benutzermodusanwendungen geben OID-Methodenanforderungen von OID_NIC_SWITCH_ENUM_VFS aus, um die VFs aufzulisten, die an den NIC-Switch eines Netzwerkadapters angefügt sind.
Bevor der Treiber oder die Anwendung die OID-Anforderung ausgibt, muss er eine NDIS_NIC_SWITCH_VF_INFO_ARRAY Struktur initialisieren, die zusammen mit der Anforderung übergeben wird. Der Treiber oder die Anwendung muss bei der Initialisierung der NDIS_NIC_SWITCH_VF_INFO_ARRAY-Struktur die folgenden Richtlinien befolgen:
Wenn das flag NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH im Flags-Element festgelegt ist, muss der Treiber oder die Anwendung das SwitchId-Element auf den NIC-Switch-Bezeichner des SR-IOV-Netzwerkadapters festlegen. Wenn Sie diese Member auf diese Weise festlegen, werden VF-Informationen nur für den angegebenen NIC-Switch auf dem SR-IOV-Netzwerkadapter zurückgegeben.
Hinweis Der überlastende Treiber und die Benutzermodusanwendung können die NIC-Switch-IDs abrufen, indem sie eine OID-Abfrageanforderung von OID_NIC_SWITCH_ENUM_SWITCHES.
Wenn das Flags-Element auf 0 festgelegt ist, muss der Treiber oder die Anwendung den SwitchId-Member auf 0 festlegen. Wenn Sie diese Member auf diese Weise festlegen, 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 im Flags-Member festgelegten Flags muss das SwitchId-Element auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.
Weitere Informationen zu NIC-Switches finden Sie unter NIC-Switches.
Zurückgeben von Statuscodes
NDIS verarbeitet die OID-Methodenanforderung der OID_NIC_SWITCH_ENUM_VFS-Anforderung für Miniporttreiber. Die Treiber erhalten diese OID-Anforderung nicht.
Wenn NDIS die OID_NIC_SWITCH_ENUM_VFS-Anforderung verarbeitet, gibt es einen der folgenden status Codes zurück.
| Statuscode | BESCHREIBUNG |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
NDIS_STATUS_NOT_SUPPORTED |
Der Miniporttreiber unterstützt entweder nicht die SR-IOV-Schnittstelle (Single Root I/O Virtualization) oder ist nicht für die Verwendung der Schnittstelle aktiviert. |
NDIS_STATUS_INVALID_PARAMETER |
Mindestens ein Member der NDIS_NIC_SWITCH_VF_INFO_ARRAY-Struktur weisen ungültige Werte auf. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. NDIS legt die DATEN fest. METHOD_INFORMATION. BytesNeeded-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) |