DOT11_PHY_TYPE_INFO structure (windot11.h)

The DOT11_PHY_TYPE_INFO structure defines parameters that the 802.11 station uses to configure a PHY when 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.

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 using its own settings for the scan operation.

uProbeDelay

The amount of time, in microseconds, that the 802.11 station must wait before transmitting an 802.11 Probe Request frame during active scanning.

uMinChannelTime

The minimum amount of time, in 802.11 time units (TU), that the 802.11 station spends on each channel when scanning. One TU is 1024 microseconds.

This member must be greater than or equal to uProbeDelay .

uMaxChannelTime

The maximum amount of time, in 802.11 time units (TU), that the 802.11 station spends on each channel when scanning.

This member must be greater than or equal to uProbeDelay .

ChDescriptionType

This member specifies the method 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[1]

An array containing channel descriptions for the PHY type specified in the dot11PhyType member.

Remarks

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

For more information about the scan operations performed by a Native 802.11 miniport driver, see Native 802.11 Scan Operations.

For more information about the ExtSTA operation mode, see Extensible Station Operation Mode.

Requirements

See also

DOT11_SCAN_REQUEST_V2

OID_DOT11_SCAN_REQUEST