OID_PNP_QUERY_POWER (Windows Embedded CE 6.0)
1/6/2010
This object requests the miniport to indicate whether it can transition its NIC to the low-power state specified in the InformationBuffer of an associated NdisRequest query. The following table shows the NDIS_DEVICE_POWER_STATE values that indicate low-power state.
Value | Description |
---|---|
NdisDeviceStateD1 |
This specifies a device state of D1. |
NdisDeviceStateD2 |
This specifies a device state of D2. |
NdisDeviceStateD3 |
This specifies a device state of D3. |
An OID_PNP_QUERY_POWER request is not used to request a transition to a device state of D0. NDIS simply sends an OID_PNP_SET_POWER request that specifies a device state of D0.
By returning NDIS_STATUS_SUCCESS to this request, the miniport guarantees that it will transition the NIC to the specified device power state on receipt of a subsequent OID_PNP_SET_POWER request. The miniport, in this case, must do nothing to jeopardize the transition.
An OID_PNP_QUERY_POWER request is always followed by an OID_PNP_SET_POWER request. The OID_PNP_SET_POWER request may immediately follow the OID_PNP_QUERY_POWER request or may arrive at an unspecified interval after the OID_PNP_QUERY_POWER request. A device state of D0 specified in the OID_PNP_SET_POWER request effectively cancels the OID_PNP_QUERY_POWER request.
An intermediate driver must always return NDIS_STATUS_SUCCESS to a query of OID_PNP_QUERY_POWER. An intermediate driver should never propagate an OID_PNP_QUERY_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_SET_POWER