Share via


OID_PNP_CAPABILITIES (Windows Embedded CE 6.0)

1/6/2010

This object requests a miniport to return the wake-up capabilities of its NIC or requests an intermediate driver to return the intermediate driver's wake-up capabilities. The wake-up capabilities are formatted as an NDIS_PNP_CAPABILITIES.

Remarks

Ee486263.collapse(en-US,WinEmbedded.60).gifMiniport Drivers

After the miniport completes initialization, both the protocol driver and NDIS can query the miniport with this OID to determine the following:

  • Whether the miniport is Power Management aware (PM-aware).
  • The NIC's capabilities of indicating network wake-up events.

If the miniport returns NDIS_STATUS_SUCCESS to a query of OID_PNP_CAPABILITIES, NDIS considers the miniport to be PM-aware. If the miniport returns NDIS_STATUS_NOT_SUPPORTED, NDIS considers the miniport to be a legacy miniport that is not PM-aware.

A miniport's NIC can support any combination of wake-up events, including no wake-up events. A miniport can support power management even if its NIC cannot signal wake-up events. In this case, the miniport supports the following power management objects:

If a miniport's NIC does not support a particular wake-up event, the miniport should indicate an NDIS_DEVICE_POWER_STATE of NdisDeviceStateUnspecified for the wake-up event in the NDIS_PM_WAKE_UP_CAPABILITIES structure.

OID_PNP_CAPABILITIES only indicates the wake-up capabilities of a miniport's NIC; it does not enable such capabilities. OID_PNP_ENABLE_WAKE_UP is used to enable a NIC's wake-up capabilities.

Ee486263.collapse(en-US,WinEmbedded.60).gifFor Intermediate Drivers

If the underlying NIC is PM-aware, the intermediate driver should return NDIS_STATUS_SUCCESS to a query of OID_PNP_CAPABILITIES. In the NDIS_PM_WAKE_UP_CAPABILITIES structure returned by this object, the intermediate driver should specify a device power state of NdisDeviceStateUnspecified for each wake-up capability (MinMagicPacketWakeUp, MinPatternWakeUp, MinLinkChangeWakeUp). Such a response indicates that the intermediate driver is PM-aware but does not manage a physical device.

If the underlying NIC is not PM-aware, the intermediate driver should return NDIS_STATUS_NOT_SUPPORTED to a query of OID_PNP_CAPABILITIES.

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_PNP_CAPABILITIES
NDIS_PM_WAKE_UP_CAPABILITIES
OID_PNP_ENABLE_WAKE_UP
OID_PNP_QUERY_POWER
OID_PNP_SET_POWER