OID_NIC_SWITCH_ENUM_VFS

Artikel
06/14/2023

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.