OID_NIC_SWITCH_CREATE_SWITCH

Artikel
03/13/2025

NDIS gibt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_CREATE_SWITCH aus, um einen NIC-Switch auf einem Netzwerkadapter zu erstellen. Bei der Verarbeitung dieser OID-Anforderung weist der Miniporttreiber die Ressourcen für den NIC-Switch auf dem Adapter zu.

NDIS gibt diese OID-Methodenanforderung an den Miniporttreiber der PCI Express (PCIe) Physical Function (PF) des Netzwerkadapters aus. Diese OID-Methodenanforderung ist für PF-Miniporttreiber erforderlich, die die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) unterstützen.

Hinweis Überlastungstreiber, z. B. Protokoll- oder Filtertreiber, können keine OID-Methodenanforderungen von OID_NIC_SWITCH_CREATE_SWITCH an den PF-Miniporttreiber ausgeben.

Das InformationBuffer-element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_NIC_SWITCH_PARAMETERS Struktur.

Bemerkungen

Wenn sie die OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCH empfängt, muss der PF-Miniporttreiber Folgendes ausführen:

Wenn der PF Miniport-Treiber die Erstellung und Konfiguration von statischen Switchen unterstützt, wird der NIC-Switch erstellt, wenn NDIS MiniportInitializeEx-aufruft. Wenn der Treiber diese OID-Anforderung verarbeitet, muss er die Konfigurationsparameter in der NDIS_NIC_SWITCH_PARAMETERS Struktur überprüfen. Die Parameter müssen mit denen übereinstimmen, die vom Treiber zum Erstellen des Schalters während des Aufrufs von MiniportInitializeExverwendet werden. Wenn dies nicht der Fall ist, muss der Treiber die OID-Anforderung nicht bestehen.

Weitere Informationen finden Sie unter Statische Erstellung eines NIC-Switches.
Wenn der PF-Miniporttreiber die Erstellung und Konfiguration von dynamischen Switchen unterstützt, muss der Treiber die Konfigurationswerte der NDIS_NIC_SWITCH_PARAMETERS Struktur überprüfen und den NIC-Switch basierend auf diesen Werten erstellen.

Weitere Informationen finden Sie unter dynamische Erstellung eines NIC Switch.
Der PF-Miniporttreiber muss die erforderlichen Hardware- und Softwareressourcen für den Standard-VPort auf dem NIC-Switch zuordnen.

Hinweis Der Standard-VPort wird immer über eine OID-Anforderung von OID_NIC_SWITCH_CREATE_SWITCH erstellt und über eine OID-Anforderung von OID_NIC_SWITCH_DELETE_SWITCHgelöscht. OID-Anforderungen von OID_NIC_SWITCH_CREATE_VPORT und OID_NIC_SWITCH_DELETE_VPORT werden für die Erstellung und Löschung von nicht standardmäßigen VPorts auf dem NIC-Switch verwendet.
Der PF-Miniport-Treiber, der die Erstellung und Konfiguration von dynamischen Switchen unterstützt, muss SR-IOV Virtualisierung auf dem Switch aktivieren, indem NdisMEnableVirtualizationaufgerufen wird. Dieser Aufruf konfiguriert die NumVFs Member und das VF Enable Bit in der SR-IOV Extended Capability-Struktur des PCI Express (PCIe)-Konfigurationsraums des Adapters.

Weitere Informationen zum SR-IOV Konfigurationsspeicherplatz finden Sie in der Spezifikation PCI-SIG Single Root I/O Virtualization and Sharing 1.1.

Hinweis Wenn der PF-Miniporttreiber die Erstellung statischer Switche unterstützt, wird SR-IOV Virtualisierung aktiviert, nachdem der Switch erstellt wurde, wenn MiniportInitializeEx aufgerufen wird.

Wenn der PF Miniport-Treiber die OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCH erfolgreich abgeschlossen hat, kann folgendes auftreten:

VFs können auf dem NIC-Switch über OID-Methodenanforderungen von OID_NIC_SWITCH_ALLOCATE_VFzugeordnet werden.
Nicht standardmäßige VPorts können auf dem NIC-Switch über OID-Methodenanforderungen von OID_NIC_SWITCH_CREATE_VPORTerstellt werden.

Weitere Informationen zum Behandeln dieser OID-Anforderung finden Sie unter Behandeln der OID_NIC_SWITCH_CREATE_SWITCH Anforderung.

Rückgabestatuscodes

Der PF-Miniport-Treiber gibt einen der folgenden Statuscodes für die OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCH zurück.

Statuscode	Beschreibung
NDIS_STATUS_SUCCESS	Die OID-Anforderung wurde erfolgreich abgeschlossen.
NDIS_STATUS_NOT_SUPPORTED	Der PF-Miniporttreiber unterstützt weder die SR-IOV Schnittstelle noch ist die Verwendung der Schnittstelle aktiviert.
NDIS_STATUS_INVALID_PARAMETER	Mindestens ein Element der NDIS_NIC_SWITCH_PARAMETERS-Struktur hat ungültige Werte.
NDIS_STATUS_INVALID_LENGTH	Die Länge des Informationspuffers ist kleiner als die Größe(NDIS_NIC_SWITCH_PARAMETERS). Der PF-Miniporttreiber muss die DATA festlegen. 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.