OID_PNP_SET_POWER (Windows CE 5.0)
This object notifies a miniport that its NIC will be transitioning to the device power state specified in the InformationBuffer of an associated NdisRequest query. The following table shows the device power state that is specified as a NDIS_DEVICE_POWER_STATE value.
| Value | Description |
|---|---|
| NdisDeviceStateD0 | This specifies a device state of D0. |
| NdisDeviceStateD1 | This specifies a device state of D1. |
| NdisDeviceStateD2 | This specifies a device state of D2. |
| NdisDeviceStateD3 | This specifies a device state of D3. |
The miniport must always return NDIS_STATUS_SUCCESS to an OID_PNP_SET_POWER request.
An OID_PNP_SET_POWER request may or may not be preceded by an OID_PNP_QUERY_POWER request.
Before a miniport returns NDIS_STATUS_SUCCESS, it must fully prepare the NIC hardware for the indicated network device power state. The tasks performed by the miniport to accomplish this are device-dependent.
Before a NIC transitions to the D3 state, its miniport must turn-off everything under the miniport's control: interrupts must disabled, timers must be cancelled, and so forth. A miniport cannot access the NIC hardware after the bus driver sets the NIC to the D3 state.
An intermediate driver must always return NDIS_STATUS_SUCCESS to a query of OID_PNP_SET_POWER. An intermediate driver should never propagate an OID_PNP_SET_POWER request to an underlying miniport.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Ntddndis.h.
See Also
NDIS_REQUEST | NdisRequest | NDIS_PM_PACKET_PATTERN | NDIS_PNP_CAPABILITIES | OID_PNP_QUERY_POWER
Send Feedback on this topic to the authors