Share via


OID_PNP_SET_POWER (Windows Embedded CE 6.0)

1/6/2010

This object notifies a miniport that its NIC will be transitioning to the device power state specified in the InformationBuffer of an associatedNdisRequestquery. 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

Header ntddndis.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Plug and Play and Power Management Object Identifiers
NDIS_REQUEST
NdisRequest
NDIS_PM_PACKET_PATTERN
NDIS_PNP_CAPABILITIES
OID_PNP_QUERY_POWER