Freigeben über


OID_NIC_SWITCH_ALLOCATE_VF

Ein übersteigender Treiber gibt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_ALLOCATE_VF aus, um Ressourcen für eine PCI Express (PCIe) Virtual Function (VF) zuzuweisen. Der VF wird auf einem Netzwerkadapter verfügbar gemacht, der die SR-IOV-Schnittstelle (Single Root E/O Virtualization) unterstützt.

Überlastende Treiber stellen diese OID-Methodenanforderung an den Miniporttreiber für die PCIe Physical Function (PF) des Netzwerkadapters aus. Diese Anforderung der OID-Methode ist für PF-Miniporttreiber erforderlich, die die SR-IOV-Schnittstelle (Single Root I/O Virtualization) 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-Miniporttreiber ordnet Softwareressourcen für eine VF zu, wenn der Treiber eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_ALLOCATE_VF verarbeitet. Obwohl die Hardwareressourcen für eine VF zugewiesen wurden, gilt sie als nicht betriebsbereit, bis der PF-Miniporttreiber die OID_NIC_SWITCH_ALLOCATE_VF erfolgreich abgeschlossen hat.

Weitere Informationen zum Zuordnen von VF-Ressourcen finden Sie unter Zuweisen von Ressourcen für eine virtuelle Funktion.

Hinweis Nachdem ein übermäßiger Treiber die Ressourcenzuordnung für eine VF angefordert hat, ist dieser Treiber die einzige Komponente, die die Freigabe der Ressourcen für denselben VF anfordern kann. Der überlastende Treiber muss eine OID-Set-Anforderung von OID_NIC_SWITCH_FREE_VF ausgeben, um die VF-Ressourcen freizugeben. Bevor der überlastete Treiber angehalten werden kann, muss er die Ressourcen für jeden VF freigeben, der durch die OID_NIC_SWITCH_ALLOCATE_VF-Anforderung des Treibers zugewiesen wurde.

Zurückgeben von Statuscodes

Der PF-Miniporttreiber gibt einen der folgenden status Codes 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 entweder nicht die SR-IOV-Schnittstelle (Single Root E/O Virtualization) oder ist für die Verwendung der Schnittstelle nicht aktiviert.

NDIS_STATUS_INVALID_PARAMETER

Mindestens ein Member der NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur hat ungültige Werte.

NDIS_STATUS_INVALID_LENGTH

Die Länge des Informationspuffers ist kleiner als sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). Der PF-Miniporttreiber muss die DATEN festlegen. METHOD_INFORMATION. BytesNeeded-Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_FAILURE

Die Anforderung ist aus anderen Gründen fehlgeschlagen.

Requirements (Anforderungen)

Version

Unterstützt in NDIS 6.30 und höher.

Header

Ntddndis.h (include Ndis.h)

Weitere Informationen


NDIS_MAKE_RID

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

NDIS_NIC_SWITCH_VF_PARAMETERS

OID_NIC_SWITCH_FREE_VF