OID_PNP_CAPABILITIES (Windows CE 5.0)
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
Send Feedback on this topic to the authors