NDIS_STATUS_PM_WOL_PATTERN_REJECTED

The NDIS_STATUS_PM_WOL_PATTERN_REJECTED status indicates to overlying drivers that a power management wake on LAN (WOL) pattern was rejected.

Remarks

NDIS or miniport drivers can generate the NDIS_STATUS_PM_WOL_PATTERN_REJECTED status indication when either of them removes a WOL pattern. The StatusBuffer member of the NDIS_STATUS_INDICATION structure contains a ULONG for the WOL pattern identifier of the rejected WOL pattern. NDIS provided the WOL pattern identifier in the PatternId member of the NDIS_PM_WOL_PATTERN structure.

NDIS generates an NDIS_STATUS_PM_WOL_PATTERN_REJECTED status indication when it must remove a previously added WOL pattern from a network adapter. For example, NDIS might remove the WOL pattern to free resources for a higher priority WOL pattern. The notification event will only be sent to the binding that added the removed pattern.

For wireless network adapters that use infrastructure elements to offload the patterns and roam across the infrastructure, it is possible that a new infrastructure element might not support the same capabilities as the previous one. In this case, the miniport driver can issue a status indication to NDIS, and NDIS will issue NDIS_STATUS_PM_WOL_PATTERN_REJECTED with a specific error code.

A WiFi driver might cache wake-up patterns locally. When the driver processes an OID for adding or deleting a wake-up pattern, the driver can choose to only update its local cache. The driver can defer the update of the infrastructure until it receives the OID_PM_PARAMETERS OID.

The infrastructure might not have enough resources to accommodate all of the wake-up patterns. In this case, the infrastructure can accept a partial list of the wake-up patterns. When the miniport driver completes the OID_PM_PARAMETERS set request, the driver must make NDIS_STATUS_PM_WOL_PATTERN_REJECTED status indications for each of the WOL patterns that the access point (AP) rejects.

Requirements

See also

NDIS_PM_WOL_PATTERN

NDIS_STATUS_INDICATION

OID_PM_PARAMETERS