Compartilhar via


OID_DOT11_DESIRED_COUNTRY_OR_REGION_STRING

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_DESIRED_COUNTRY_OR_REGION_STRING object identifier (OID) requests that the miniport driver set the value of the Extensible Station (ExtSTA) msDot11DesiredCountryOrRegionString management information base (MIB) object to the specified data.

When queried, OID_DOT11_DESIRED_COUNTRY_OR_REGION_STRING requests that the miniport driver return the value of the msDot11DesiredCountryOrRegionString MIB object.

The data type for OID_DOT11_DESIRED_COUNTRY_OR_REGION_STRING is the DOT11_COUNTRY_OR_REGION_STRING structure.

Note  Support for OID_DOT11_DESIRED_COUNTRY_OR_REGION_STRING is mandatory if the 802.11 station supports multiple regulatory domains as defined through the IEEE 802.11d-2001 standard. For more information about how the miniport driver specifies its support for regulatory domains, see OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.

 

The msDot11DesiredCountryOrRegionString MIB object specifies an IEEE 802.11d country string used by the 802.11 station whenever it does one of the following:

  • Associates with an access point (AP) or peer stationconnection operation. In this situation, the 802.11 station uses the msDot11DesiredCountryOrRegionString MIB object to create a BSS network candidate list in order to determine which AP or peer station it can associate with.

    For more information about the association operation, see Association Operations. For more information about the BSS network candidate list, see BSS Network Candidate List.

  • Starts a new independent BSS (IBSS) network during a connection operation. In this situation, the 802.11 station sets the IEEE 802.11Country Information Element (IE) to the value of the msDot11DesiredCountryOrRegionString MIB object in the 802.11 Beacon and Probe Response frames that the station transmits.

    For more information about the connection operation, see Connection Operations. For more information about how the 802.11 station starts an IBSS network, see Connection Operation Guidelines for Independent BSS Networks.

The default for the msDot11DesiredCountryOrRegionString MIB object is a DOT11_COUNTRY_OR_REGION_STRING string of all zeros. The miniport driver must set this MIB object to its default if any of the following occur:

  • The miniport driver's MiniportInitializeEx function is called.

  • 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.

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 Wireless LAN OIDs