OID_SRIOV_SET_VF_POWER_STATE
Ein übersteigender Treiber gibt eine OID-Set-Anforderung (Object Identifier) von OID_SRIOV_SET_VF_POWER_STATE aus, um den Energiezustand einer angegebenen PCI Express (PCIe) Virtual Function (VF) auf dem Netzwerkadapter zu ändern. Da das Ändern des Energiezustands ein privilegierter Vorgang ist, stellen überstehende Treiber diese OID-Set-Anforderung an den Miniporttreiber der PCIe Physical Function (PF) auf dem Netzwerkadapter aus. Der PF-Miniporttreiber legt dann den angegebenen Energiezustand auf der 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-Miniporttreiber diese OID-Set-Anforderung ausgestellt wird, muss er die folgenden Richtlinien befolgen:
Der PF-Miniporttreiber muss überprüfen, ob der VF, der vom VFId-Member der NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS-Struktur angegeben wird, über zuvor zugeordnete Ressourcen verfügt. Der PF-Miniporttreiber ordnet Ressourcen für eine VF während einer OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF zu. Wenn sich der angegebene VF nicht in einem zugeordneten Zustand befindet, muss der Treiber die OID-Anforderung nicht ausführen.
Der Energiezustandsvorgang darf sich nur auf den angegebenen VF auswirken. Der Vorgang darf sich nicht auf andere VFs oder die PF auf demselben Netzwerkadapter auswirken.
Weitere Informationen finden Sie unter Festlegen des Energiezustands einer virtuellen Funktion.
Zurückgeben von Statuscodes
Der PF-Miniporttreiber gibt einen der folgenden status Codes für die OID-Set-Anforderung 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 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_SRIOV_SET_VF_POWER_STATE_PARAMETERS-Struktur weisen ungültige Werte auf. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. Der PF-Miniporttreiber muss die DATEN festlegen. SET_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) |