OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED

  • Articolo

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_MULTI_DOMAIN_CAPABILITY_ENABLED object identifier (OID) requests that the miniport driver set the IEEE 802.11d dot11MultiDomainCapabilityEnabled management information base (MIB) object to the specified value.

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

Note  Support for OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED is mandatory if the 802.11 station supports more than one regulatory domain and the IEEE 802.11 dot11MultiDomainCapabilityImplemented MIB object is TRUE. For more information about this MIB object, see OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.

 

The data type for OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED is a BOOLEAN value.

If the dot11MultiDomainCapabilityEnabled MIB object is TRUE, the 802.11 station can operate in multiple regulatory domains. For more information about this MIB object, see OID_DOT11_CURRENT_REG_DOMAIN.

The 802.11 station operates in multiple regulatory domains in the following way:

  • If the dot11CurrentRegDomain MIB object is set to DOT11_REG_DOMAIN_OTHER, the 802.11 station operates dynamically in multiple regulatory domains through the procedures and protocols defined by the IEEE 802.11d-2001 standard.

  • If the dot11CurrentRegDomain MIB object is not set DOT11_REG_DOMAIN_OTHER, the 802.11 station only operates within the regulatory domain as specified by the MIB object.

    In this situation, the value of the dot11CurrentRegDomain MIB object defines the default regulatory domain of the 802.11 station. For more information about the default regulatory domain, see OID_DOT11_CURRENT_REG_DOMAIN.

    Note  The default regulatory domain can only be changed while the miniport driver is operating in the initialization (INIT) state. For more information about this state, see Native 802.11 Operating States.

     

If the dot11MultiDomainCapabilityEnabled MIB object is FALSE, the 802.11 station can only operate in its default regulatory domain.

The miniport driver fails a set or query of OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED under the following conditions:

  • If the dot11MultiDomainCapabilityImplemented MIB object is FALSE, the 802.11 station does not support multiple regulatory domains. In this situation, the miniport driver must return NDIS_STATUS_BAD_VERSION from its MiniportOidRequest function.

    For more information about the dot11MultiDomainCapabilityImplemented MIB object, see OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.

  • If the dot11MultiDomainCapabilityImplemented MIB object is TRUE and the 802.11 station does not support a default regulatory domain, it must fail the set request if the specified value of the dot11MultiDomainCapabilityEnabled MIB object is FALSE. The miniport driver must return NDIS_STATUS_INVALID_DATA from its MiniportOidRequest function.

  • If the 802.11 has not completed an explicit scan initiated through a set of OID_DOT11_SCAN_REQUEST, the miniport driver must return NDIS_STATUS_DOT11_MEDIA_IN_USE from its MiniportOidRequest function.

The default value for the dot11MultiDomainCapabilityEnabled MIB object is FALSE. The miniport driver must set this MIB object to this default when one of the following occurs:

  • The miniport driver initializes the current PHY type through its MiniportInitializeEx function.

  • A method request of OID_DOT11_RESET_REQUEST is made to reset the MAC layer of the 802.11 station and the bSetDefaultMIB member of the DOT11_RESET_REQUEST structure is TRUE.

If the miniport driver supports the functionality of multiple MAC entities through virtualization, the driver should not return NDIS_STATUS_DOT11_MEDIA_IN_USE if the medium is blocked by another MAC.

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