Share via

OID_PNP_CAPABILITIES

  • Article

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:

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Ntddndis.h.

See Also

NDIS_REQUEST | NdisRequest | NDIS_PNP_CAPABILITIES | NDIS_PM_WAKE_UP_CAPABILITIES | OID_PNP_ENABLE_WAKE_UP | OID_PNP_QUERY_POWER | OID_PNP_SET_POWER

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.