Obtaining and Updating Power Management Parameters

Protocol drivers can use the OID_PM_PARAMETERS OID to query the hardware capabilities of a network adapter that is currently enabled. After a successful return from the query, the InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to an NDIS_PM_PARAMETERS structure.

Protocol drivers can also use OID_PM_PARAMETERS as a set request to enable or disable the current hardware capabilities of a network adapter. The protocol driver provides a pointer to an NDIS_PM_PARAMETERS structure in the InformationBuffer member of the NDIS_OID_REQUEST structure.

Note  Protocol drives cannot disable capabilities that were enabled by other protocol drivers. If none of the protocol drivers enable a capability, that capability is unused.

Note  NDIS enables magic packet and low power on disconnect capabilities based on the user settings, and these capabilities cannot be disabled by protocol drivers.

NDIS_PM_PARAMETERS includes the following information:

EnabledWoLPacketPatterns
Contains flags that correspond to capabilities that the miniport driver reported in the SupportedWoLPacketPatterns member of the NDIS_PM_CAPABILITIES structure. For example, the network adapter is enabled to generate a wake-up event when it receives a bitmap, a WOL magic packet, or an EAP over LAN (EAPOL) request identifier message. For a complete list of the patterns that are possible in the current operating system, see the NDIS_PM_PARAMETERS reference page.

EnabledProtocolOffloads
Contains flags that correspond to capabilities that the miniport driver reported in the SupportedProtocolOffloads member of the NDIS_PM_CAPABILITIES structure. NDIS uses these flags to enable or disable the low power protocol offload capabilities on a network adapter. For example, the network adapter offload for IPv4 ARP, IPv6 Neighbor Solicitation (NS), or IEEE 802.11 robust secure network (RSN) 4-way and 2-way handshake is enabled. For a complete list of the protocol offloads that are supported in the current operating system, see the NDIS_PM_PARAMETERS reference page.

WakeUpFlags
Contains flags that NDIS uses to enable or disable wake-up capabilities on a network adapter.

For NDIS 6.20, the NDIS_PM_WAKE_ON_LINK_CHANGE_ENABLED flag enables the capability to wake on a link change (media connect). For more information about this flag, see Low Power on Media Disconnect.

Starting with NDIS 6.30, the NDIS_PM_SELECTIVE_SUSPEND_ENABLED flag enables the support for NDIS selective suspend on underlying USB network adapters. For more information, see NDIS Selective Suspend.

When a driver sets the OID_PM_PARAMETERS OID, NDIS completes the request without forwarding it to the miniport driver. NDIS stores the requested settings and combines them with the settings from other such requests.

Before NDIS transitions the network adapter to the low power state, NDIS sends a set request to the miniport driver that contains the combined settings from all of the requests that NDIS stored. For more information about setting a low power state, see Low Power for Wake on LAN.

The capabilities that are currently enabled can be a subset of the capabilities that the hardware supports. For more information about the capabilities that the hardware supports, see Reporting Power Management Capabilities.