OID_NIC_SWITCH_CREATE_SWITCH

Artikel
06/15/2023

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

NDIS gibt diese Anforderung der OID-Methode an den Miniporttreiber des Netzwerkadapters aus. Diese Anforderung der OID-Methode ist für PF-Miniporttreiber erforderlich, die die SR-IOV-Schnittstelle (Single Root E/O Virtualization) unterstützen.

Hinweis Überlastende Treiber, 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 er die OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCH empfängt, muss der PF-Miniporttreiber die folgenden Schritte ausführen:

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

Weitere Informationen finden Sie unter Statische Erstellung eines NIC-Switches.
Wenn der PF-Miniporttreiber die Erstellung und Konfiguration eines dynamischen Switches 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-Switches.
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_SWITCH gelöscht. OID-Anforderungen von OID_NIC_SWITCH_CREATE_VPORT und OID_NIC_SWITCH_DELETE_VPORT werden zum Erstellen und Löschen von nicht standardmäßigen VPorts auf dem NIC-Switch verwendet.
Der PF-Miniporttreiber, der die Erstellung und Konfiguration eines dynamischen Switches unterstützt, muss die SR-IOV-Virtualisierung auf dem Switch aktivieren, indem NdisMEnableVirtualization aufgerufen wird. Dieser Aufruf konfiguriert den NumVFs-Member und das VF Enable-Bit in der SR-IOV Extended Capability-Struktur des PCI Express -Konfigurationsraums (PCIe) des Adapters.

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

Hinweis Wenn der PF-Miniporttreiber die Erstellung eines statischen Switches unterstützt, aktiviert er die SR-IOV-Virtualisierung, nachdem er den Switch erstellt hat, wenn MiniportInitializeEx aufgerufen wird.

Wenn der PF-Miniporttreiber die OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCH erfolgreich abgeschlossen hat, kann Folgendes erfolgen:

VFs können auf dem NIC-Switch über OID-Methodenanforderungen von OID_NIC_SWITCH_ALLOCATE_VF zugeordnet werden.
Nicht standardmäßige VPorts können auf dem NIC-Switch über OID-Methodenanforderungen von OID_NIC_SWITCH_CREATE_VPORT erstellt werden.

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

Rückgabestatuscodes

Der PF-Miniporttreiber gibt einen der folgenden status Codes 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 entweder die SR-IOV-Schnittstelle nicht oder ist für die Verwendung der Schnittstelle nicht aktiviert.
NDIS_STATUS_INVALID_PARAMETER	Mindestens ein Member der NDIS_NIC_SWITCH_PARAMETERS-Struktur weisen ungültige Werte auf.
NDIS_STATUS_INVALID_LENGTH	Die Länge des Informationspuffers ist kleiner als sizeof(NDIS_NIC_SWITCH_PARAMETERS). Der PF-Miniporttreiber muss die DATA festlegen. METHOD_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_FAILURE	Die Anforderung ist aus anderen Gründen fehlgeschlagen.