Freigeben über


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)

Weitere Informationen


NDIS_OID_REQUEST

NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF