OID_SRIOV_SET_VF_POWER_STATE
En överdrivande drivrutin utfärdar en begäran om objektidentifierare (OID) för OID_SRIOV_SET_VF_POWER_STATE för att ändra energitillståndet för en angiven virtuell PCI Express-funktion (PCIe) på nätverkskortet. Eftersom det är en privilegierad åtgärd att ändra energitillståndet utfärdar överdrivande drivrutiner denna OID-uppsättningsbegäran till miniportdrivrutinen för PCIe Physical Function (PF) på nätverkskortet. PF-miniportdrivrutinen anger sedan det angivna energitillståndet på den virtuella hårddisken.
InformationBuffer medlem i NDIS_OID_REQUEST struktur innehåller en pekare till en NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS struktur.
Anmärkningar
När PF-miniportdrivrutinen utfärdas denna OID-uppsättningsbegäran måste den följa dessa riktlinjer:
PF-miniportdrivrutinen måste kontrollera att den virtuella hårddisken, som anges av VFId medlem i NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS struktur, har resurser som tidigare har allokerats. PF-miniportdrivrutinen allokerar resurser för en VF under en OID-metodbegäran av OID_NIC_SWITCH_ALLOCATE_VF. Om den angivna virtuella hårddisken inte är i ett allokerat tillstånd måste drivrutinen misslyckas med OID-begäran.
Energitillståndsåtgärden får endast påverka den angivna virtuella hårddisken. Åtgärden får inte påverka andra virtuella datorer eller PF på samma nätverkskort.
Mer information finns i Ange energitillståndet för en virtuell funktion.
Returstatuskoder
PF-miniportdrivrutinen returnerar någon av följande statuskoder för OID-uppsättningens begäran om OID_SRIOV_SET_VF_POWER_STATE.
| Statuskod | Beskrivning |
|---|---|
NDIS_STATUS_SUCCESS |
OID-begäran har slutförts. |
NDIS_STATUS_NOT_SUPPORTED |
PF-miniportdrivrutinen stöder antingen inte det enskilda rot-I/O-virtualiseringsgränssnittet (SR-IOV) eller så är den inte aktiverad för att använda gränssnittet. |
NDIS_STATUS_INVALID_PARAMETER |
En eller flera av medlemmarna i NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS struktur har ogiltiga värden. |
NDIS_STATUS_INVALID_LENGTH |
Informationsbufferten var för kort. PF-miniportdrivrutinen måste ange DATA. SET_INFORMATION. BytesNeeded medlem i NDIS_OID_REQUEST struktur till den minsta buffertstorlek som krävs. |
NDIS_STATUS_FAILURE |
Begäran misslyckades av andra skäl. |
Krav
Version |
Stöds i NDIS 6.30 och senare. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |