OID_NIC_SWITCH_CREATE_VPORT
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) |