The OID_PNP_QUERY_POWER OID requests the miniport driver to indicate whether it can transition its network adapter to the low-power state specified in the InformationBuffer. The low-power state is specified as one of the following NDIS_DEVICE_POWER_STATE values:
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 OID request, the miniport driver guarantees that it will transition the network adapter to the specified device power state on receipt of a subsequent OID_PNP_SET_POWER request. The miniport driver, in this case, must do nothing to jeopardize the transition.
Miniport drivers must always return NDIS_STATUS_SUCCESS to this OID request. Any other return code is an error.
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 driver.
Supported for NDIS 5.1, and NDIS 6.0 and later.
|Ntddndis.h (include Ndis.h)|