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

Miniport 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:

• NDIS_PNP_CAPABILITIES
• OID_PNP_QUERY_POWER
• OID_PNP_SET_POWER

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.

For 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

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