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_ALLOCATE_VF aus, um Ressourcen für eine virtuelle PCI Express-Funktion (PCIe) (VF) zuzuweisen. Der VF wird auf einem Netzwerkadapter verfügbar gemacht, der die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) unterstützt.
Overlying drivers issue this OID method request to the miniport driver for the network adapter's PCIe Physical Function (PF). Diese OID-Methodenanforderung ist für PF-Miniporttreiber erforderlich, die die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) unterstützen.
Das InformationBuffer- Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_NIC_SWITCH_VF_PARAMETERS Struktur.
Bemerkungen
Der PF-Miniport-Treiber weist Softwareressourcen für einen VF zu, wenn der Treiber eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_ALLOCATE_VF verarbeitet. Obwohl die Hardwareressourcen für einen VF zugeordnet wurden, gilt sie als nichtoperational, bis der PF-Miniporttreiber die OID_NIC_SWITCH_ALLOCATE_VF erfolgreich abgeschlossen hat.
Weitere Informationen zum Zuordnen von VF-Ressourcen finden Sie unter Allocating Resources for a Virtual Function.
Hinweis Nachdem ein übermäßiger Treiber die Ressourcenzuordnung für einen VF anfordert, ist dieser Treiber die einzige Komponente, die die Freisetzung der Ressourcen für denselben VF anfordern kann. Der überlagernde Treiber muss eine OID-Satzanforderung von OID_NIC_SWITCH_FREE_VF ausstellen, um die VF-Ressourcen freizugeben. Bevor der überlagernde Fahrer angehalten werden kann, muss er die Ressourcen für jeden VF freigeben, der vom OID_NIC_SWITCH_ALLOCATE_VF Antrag des Fahrers zugewiesen wurde.
Rückgabestatuscodes
Der PF Miniport-Treiber gibt einen der folgenden Statuscodes für die OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF zurück.
| Statuscode | Beschreibung |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
NDIS_STATUS_NOT_SUPPORTED |
Der PF-Miniporttreiber unterstützt weder die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) noch ist die Verwendung der Schnittstelle aktiviert. |
NDIS_STATUS_INVALID_PARAMETER |
Mindestens ein Element der NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur hat ungültige Werte. |
NDIS_STATUS_INVALID_LENGTH |
Die Länge des Informationspuffers ist kleiner als die Größe(NDIS_NIC_SWITCH_VF_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) |