OID_DOT11_BEACON_PERIOD (Compact 2013)

3/26/2014

When set, this OID requests that the miniport driver set the value of the IEEE 802.11 dot11BeaconPeriod management information base (MIB) object to the specified value.

When queried, this OID requests that the miniport driver return the value of the dot11BeaconPeriod MIB object.

The dot11BeaconPeriod MIB object is used by the 802.11 station for scheduling the transmission of 802.11 Beacon frames. This value is also specified in the Beacon Interval field of the 802.11 Beacon and Probe Response frames sent by the station.

The data type for this OID is a ULONG value that specifies the beacon period in 802.11 time units (TU). One TU is 1024 microseconds. The dot11BeaconPeriod MIB object has a value from 1 through 65535.

Note

If the miniport driver is operating in the Extensible Station (ExtSTA) mode, it can transmit Beacon or Probe Response frames only if the desired BSS type is set to dot11_BSS_type_independent. For more information about the desired BSS type, see OID_DOT11_DESIRED_BSS_TYPE.

If the miniport driver is operating in ExtSTA mode, the driver and 802.11 station must do the following when set by OID_DOT11_BEACON_PERIOD:

  • The desired BSS type must have previously been set to dot11_BSS_type_independent through OID_DOT11_DESIRED_BSS_TYPE. If not, the miniport driver must fail the set request by returning NDIS_STATUS_INVALID_DATA from its MiniportOidRequest function.
  • After the OID is set, the 802.11 station uses the specified beacon period only if it starts an IBSS network.

When queried by OID_DOT11_BEACON_PERIOD, the miniport driver must do the following:

  • If the 802.11 station associates with an ESS or joins an IBSS, return the beacon period from the most recently received Beacon or Probe Response.
  • If the 802.11 station starts an IBSS, return the value of dot11BeaconPeriod from the previous set of OID_DOT11_BEACON_PERIOD.

Requirements

Header

windot11.h

See Also

Reference

NDIS 5.x Legacy Wireless LAN OIDs
OID_DOT11_DESIRED_BSS_TYPE
MiniportOidRequest
NDIS 5.x Legacy Reference