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 gibt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_CREATE_VPORT aus, um einen nicht standardmäßigen virtuellen Port (VPort) auf dem NIC-Switch eines Netzwerkadapters zu erstellen. Diese OID-Methodenanforderung fügt auch den erstellten VPort an die PCI Express (PCIe) Physical Function (PF) des Netzwerkadapters oder eine zuvor zugeordnete PCIe Virtual Function (VF) an.
Überlying-Treiber stellen diese OID-Methodenanforderung an den Miniporttreiber für die PF des Netzwerkadapters aus. Diese OID-Methodenanforderung ist für PF-Miniporttreiber erforderlich, die die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) unterstützen.
Das InformationBuffer Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf die NDIS_NIC_SWITCH_VPORT_PARAMETERS Struktur.
Bemerkungen
Der übersteigende Treiber initialisiert die NDIS_NIC_SWITCH_VPORT_PARAMETERS Struktur mit den Konfigurationsinformationen zum zu erstellenden nicht standardmäßigen VPort. Die Konfigurationsinformationen enthalten die PCIe-Funktion, an die der nicht standardmäßige VPort angefügt ist, und die Anzahl der Warteschlangenpaare für den nicht standardmäßigen VPort.
Wenn der PF Miniport-Treiber die OID-Anforderung ausgestellt wird, weist der Treiber die Hardware- und Softwareressourcen zu, die dem angegebenen nicht standardmäßigen VPort zugeordnet sind. Nachdem alle Ressourcen erfolgreich zugeordnet wurden, schließt der PF Miniport-Treiber den OID erfolgreich ab, indem er NDIS_STATUS_SUCCESS von MiniportOidRequestzurückgibt.
Wenn die OID_NIC_SWITCH_CREATE_VPORT Anforderung erfolgreich abgeschlossen wird, muss der PF-Miniporttreiber und der Überlauftreiber den VPortId- Wert des nicht standardmäßigen VPort für aufeinander folgende Vorgänge beibehalten. Der VPortId- Wert wird während dieser Vorgänge verwendet:
NDIS und die übermäßigen Treiber verwenden den VPortId- Wert, um den nicht standardmäßigen VPort in aufeinander folgenden OID-Anforderungen im Zusammenhang mit diesem VPort zu identifizieren, z. B. OID_NIC_SWITCH_VPORT_PARAMETERS und OID_NIC_SWITCH_DELETE_VPORT.
Bei Sendevorgängen gibt NDIS den VPortId- Wert an, um den VPort zu identifizieren, von dem ein Paket gesendet wurde. Dieser Wert wird innerhalb der Out-of-Band-NDIS_NET_BUFFER_LIST_FILTERING_INFO Daten der NET_BUFFER_LIST Struktur angegeben.
Bei Empfangsvorgängen gibt der PF-Miniporttreiber den VPortId- Wert an, an den ein Paket weitergeleitet werden soll. Dieser Wert wird auch in den OOB-NDIS_NET_BUFFER_LIST_FILTERING_INFO Daten der NET_BUFFER_LIST Struktur angegeben.
Weitere Informationen finden Sie unter Erstellen eines virtuellen Port.
Hinweis Der Standard-VPort ist immer vorhanden und wird nicht erstellt, obwohl eine OID-Anforderung von OID_NIC_SWITCH_CREATE_VPORT. Der Standard-VPort verfügt über einen Bezeichner von NDIS_DEFAULT_VPORT_ID. Wenn der PF-Miniporttreiber einen NIC-Switch erstellt, fügt der Treiber automatisch den Standard-VPort an den PF des Netzwerkadapters an.
Rückgabestatuscodes
NDIS oder der PF-Miniporttreiber 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_VPORT_PARAMETERS-Struktur hat ungültige Werte. |
NDIS_STATUS_INVALID_LENGTH |
Die Länge des Informationspuffers ist kleiner als die Größe(NDIS_NIC_SWITCH_VPORT_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. |
Anforderungen
Version |
Unterstützt in NDIS 6.30 und höher. |
Kopfball |
Ntddndis.h (include Ndis.h) |