Share via

OID_PNP_SET_POWER (Compact 2013)

  • Article

3/26/2014

This object notifies a miniport that its network adapter 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.

  • 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 network adapter hardware for the indicated network device power state. The tasks that are performed by the miniport to accomplish this are device-dependent.

Before a network adapter transitions to the D3 state, its miniport must turn-off everything under the miniport's control: interrupts must disabled, timers must be canceled, and so on. A miniport cannot access the network adapter hardware after the bus driver sets the network adapter 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

See Also

Reference

Operational OIDs
NDIS_REQUEST
NdisRequest
NDIS_PM_PACKET_PATTERN
NDIS_PNP_CAPABILITIES
OID_PNP_QUERY_POWER