OID_SRIOV_SET_VF_POWER_STATE
Ein übermäßiger Treiber gibt eine OID-Setanforderung (Object Identifier) von OID_SRIOV_SET_VF_POWER_STATE aus, um den Leistungszustand einer angegebenen VIRTUELLEN PCI Express -Funktion (PCIe) auf dem Netzwerkadapter zu ändern. Da es sich beim Ändern des Energiezustands um einen privilegierten Vorgang handelt, stellen Überleitungstreiber diese OID-Setanforderung an den Miniporttreiber der PCIe Physical Function (PF) auf dem Netzwerkadapter aus. Der PF-Miniporttreiber legt dann den angegebenen Leistungszustand auf dem VF fest.
Das InformationBuffer-element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS Struktur.
Bemerkungen
Wenn der PF Miniport-Treiber diese OID-Set-Anforderung ausgestellt wird, muss er die folgenden Richtlinien befolgen:
Der PF-Miniporttreiber muss überprüfen, ob der VFId, der durch das VFId- Mitglied der NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS-Struktur angegeben ist, Über Ressourcen verfügt, die zuvor zugeordnet wurden. Der PF Miniport-Treiber weist ressourcen für einen VF während einer OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VFzu. Wenn sich der angegebene VF nicht in einem zugewiesenen Zustand befindet, muss der Treiber die OID-Anforderung nicht ausführen.
Der Energiezustandsvorgang darf sich nur auf den angegebenen VF auswirken. Der Vorgang darf keine Auswirkungen auf andere VFs oder den PF auf demselben Netzwerkadapter haben.
Weitere Informationen finden Sie unter Festlegen des Energiezustands einer virtuellen Funktion.
Rückgabestatuscodes
Der PF Miniport-Treiber gibt einen der folgenden Statuscodes für die OID-Setanforderung von OID_SRIOV_SET_VF_POWER_STATE 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_SRIOV_SET_VF_POWER_STATE_PARAMETERS-Struktur hat ungültige Werte. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. Der PF-Miniporttreiber muss die DATA festlegen. SET_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) |