Expand Minimize

OID_DOT11_REG_DOMAINS_SUPPORT_VALUE

When queried, the OID_DOT11_REG_DOMAINS_SUPPORT_VALUE object identifier (OID) requests that the miniport driver return the list of regulatory domains supported by the Physical Layer Convergence Procedure (PLCP) and Physical Media Dependent (PMD) sublayers of the current PHY type on the 802.11 station.

The data type for OID_DOT11_REG_DOMAINS_SUPPORT_VALUE is the DOT11_REG_DOMAINS_SUPPORT_VALUE structure.



    typedef struct _DOT11_REG_DOMAINS_SUPPORT_VALUE {
         ULONG uNumOfEntries;
         ULONG uTotalNumOfEntries;
         DOT11_REG_DOMAIN_VALUE dot11RegDomainValue[1];
    } DOT11_REG_DOMAINS_SUPPORT_VALUE,   *PDOT11_REG_DOMAINS_SUPPORT_VALUE;
  

This structure includes the following members:

uNumOfEntries

Number of entries in the dot11RegDomainValue array. A zero value for this member indicates an empty list of supported regulatory domains.

uTotalNumOfEntries

Maximum number of entries that the dot11RegDomainValue array requires.

dot11RegDomainValue

The list of supported regulatory domains.

The data type for the elements of the dot11RegDomainValue array is the DOT11_REG_DOMAIN_VALUE structure.

typedef struct _DOT11_REG_DOMAIN_VALUE {         ULONG uRegDomainsSupportIndex;
 ULONG
 uRegDomainsSupportValue; } DOT11_REG_DOMAIN_VALUE, *PDOT11_REG_DOMAIN_VALUE;

This structure includes the following members:

uRegDomainsSupportIndex

Identifies this entry in the miniport driver's supported regulatory domain list.

uRegDomainsSupportValue

The value of the regulatory domain, which is defined in the following table.

NameValueRegulatory domain

DOT11_REG_DOMAIN_OTHER

0x00000000

Defined by country code settings

DOT11_REG_DOMAIN_FCC

0x00000010

United States

DOT11_REG_DOMAIN_DOC

0x00000020

Canada

DOT11_REG_DOMAIN_ETSI

0x00000030

Most of Europe

DOT11_REG_DOMAIN_SPAIN

0x00000031

Spain

DOT11_REG_DOMAIN_FRANCE

0x00000032

France

DOT11_REG_DOMAIN_MKK

0x00000040

Japan

 

When OID_DOT11_REG_DOMAINS_SUPPORT_VALUE is queried, the miniport driver must verify that the InformationBuffer member of the MiniportOidRequest function's OidRequest parameter is large enough to return the entire DOT11_REG_DOMAINS_SUPPORT_VALUE structure, including all entries in the dot11RegDomainValue array. The value of the InformationBufferLength member of the OidRequest parameter determines what the miniport driver must do, for example:

  • If the value of the InformationBufferLength member is less than the length, in bytes, of the entire DOT11_REG_DOMAINS_SUPPORT_VALUE structure, the miniport driver must do the following:

    • For the OidRequest parameter, set the BytesWritten member to zero and the BytesNeeded member to the length, in bytes, of the entire DOT11_REG_DOMAINS_SUPPORT_VALUE structure.

    • Fail the query request by returning NDIS_STATUS_BUFFER_OVERFLOW from its MiniportOidRequest function.

  • If the value of the InformationBufferLength member is greater than or equal to than the length, in bytes, of the entire DOT11_REG_DOMAINS_SUPPORT_VALUE structure, the miniport driver must do the following to complete a successful query request:

    • For the DOT11_REG_DOMAINS_SUPPORT_VALUE structure, set the uNumOfEntries and uTotalNumOfEntries members to the total number of entries in the dot11RegDomainValue array.

    • For the OidRequest parameter, set the BytesNeeded member to zero and the BytesWritten member to the length, in bytes, of the entire DOT11_REG_DOMAINS_SUPPORT_VALUE structure. The miniport driver must also copy the entire DOT11_REG_DOMAINS_SUPPORT_VALUE structure to the InformationBuffer member.

    • Return NDIS_STATUS_SUCCESS from its MiniportOidRequest function.

If the miniport driver is operating in Extensible Station (ExtSTA) mode, the current PHY type is determined through the ExtSTA msDot11CurrentPhyID management information base (MIB) object. This MIB object specifies the index of the current PHY type within the 802.11 station's list of supported PHY types. For more information about msDot11CurrentPhyID, see OID_DOT11_CURRENT_PHY_ID.

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

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.