DOT11_PHY_TYPE_INFO (Compact 2013)

  • Articolo

3/26/2014

This structure defines parameters that the 802.11 station uses to configure a PHY when the 802.11 station is performing an explicit scan operation. The station performs the explicit scan operation following a set request of OID_DOT11_SCAN_REQUEST.

Syntax

typedef struct _DOT11_PHY_TYPE_INFO {
  union {
    DOT11_PHY_TYPE  dot11PhyType;
    ULONG  uPhyId;
  };
  BOOLEAN  bUseParameters;
  ULONG  uProbeDelay;
  ULONG  uMinChannelTime;
  ULONG  uMaxChannelTime;
  CH_DESCRIPTION_TYPE  ChDescriptionType;
  ULONG  uChannelListSize;
  UCHAR  ucChannelListBuffer[1];
} DOT11_PHY_TYPE_INFO, *PDOT11_PHY_TYPE_INFO;

Members

  • dot11PhyType
    The type of PHY that the 802.11 station will use for the scan. The PHY type is defined by the DOT11_PHY_TYPE enumeration.

    Note

    The miniport driver must ignore this member if it is operating in Extensible Station (ExtSTA) mode.

  • uPhyId
    The identifier (ID) of the PHY that the 802.11 station will use for the scan. The PHY ID is the index within the list of supported PHYs returned by the driver through a query of OID_DOT11_SUPPORTED_PHY_TYPES.

    Note

    The miniport driver must ignore this member if it is operating in ExtSTA mode.

  • bUseParameters
    If this member is TRUE, the 802.11 station uses the other members of this structure to configure the PHY for the scan operation.

    If this member is FALSE, the 802.11 station configures the PHY by using its own settings for the scan operation.

    Note

    If the miniport driver is operating in ExtSTA mode, the operating system will always set this member to FALSE.

  • uProbeDelay
    How long, in microseconds, that the 802.11 station must wait before transmitting an 802.11 Probe Request frame during active scanning.

  • uMinChannelTime
    The minimum time, in 802.11 time units (TU), that the 802.11 station spends on each channel when it scans. One TU is 1024 microseconds.

    This member must be greater than or equal to uProbeDelay.

  • uMaxChannelTime
    The maximum time, in 802.11 time units (TU), that the 802.11 station spends on each channel when it scans.

    This member must be greater than or equal to uProbeDelay.

  • ChDescriptionType
    This member specifies the method that is used to interpret the entries in the ucChannelListBuffer array. The data type for this member is the CH_DESCRIPTION_TYPE enumeration, which declares the following values:

    ch_description_type_logical

    The channel entry is defined by a logical channel number to conform with the IEEE 802.11 standard.

    ch_description_type_center_frequency

    The channel entry is defined, in units of megahertz (MHz), by a channel center frequency.
  • uChannelListSize
    The length, in bytes, of the ucChannelListBuffer array. Each entry in this array is formatted as a ULONG data type.
  • ucChannelListBuffer
    An array that contains channel descriptions for the PHY type specified in the dot11PhyType member.

Remarks

The DOT11_SCAN_REQUEST_V2 structure. This accompanies a set request of OID_DOT11_SCAN_REQUEST, contains an array of zero or more DOT11_PHY_TYPE_INFO entries.

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Data Types
OID_DOT11_SCAN_REQUEST
OID_DOT11_SUPPORTED_PHY_TYPES
DOT11_SCAN_REQUEST_V2
Native 802.11 Wireless LAN Reference

Other Resources

DOT11_PHY_TYPE