OID_DOT11_BEACON_PERIOD

  • Article

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

 

When set, the OID_DOT11_BEACON_PERIOD object identifier (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.

Note  If the miniport driver is operating in the Extensible AP (ExtAP) mode, the following requirements apply:

  • Support for this OID is mandatory.

  • The driver must successfully complete a set request. If the msDot11AutoConfigEnabled MIB object has the automatic MAC configuration flag DOT11_MAC_AUTO_CONFIG_ENABLED_FLAG set, the miniport driver can choose to use a different MAC value.

  • In response to a query request, the miniport driver should return the actual value of the Beacon frame period (the time interval between two Beacons) that the miniport driver uses.

 

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 OID_DOT11_BEACON_PERIOD 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 only transmit Beacon or Probe Response frames 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 has been 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.

Note  A Native 802.11 miniport driver that is designed to run on the Windows Vista or Windows Server 2008 operating systems must always reset this 802.11 MIB OID to its default value. This is the case regardless of the value of the bSetDefaultMIB member of the DOT11_RESET_REQUEST structure. This requirement applies to a miniport driver that, in a call to the NdisMSetMiniportAttributes function, sets MiniportAttributes -> Native_802_11_Attributes -> Header -> Revision to NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_1.

 

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

 Windot11.h (include Ndis.h)

See also

Native 802.11 MIB OIDs

Native 802.11 Wireless LAN OIDs