OID_NIC_SWITCH_ALLOCATE_VF

Artikel
06/15/2023

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.