OID_802_11_CONFIGURATION
When set, the OID_802_11_CONFIGURATION OID requests that the miniport driver set the underlying NIC's radio configuration parameters to the specified values. If invalid configuration data is specified, the miniport driver returns NDIS_STATUS_INVALID_DATA.
This OID can only be set when the device is not associated within the desired SSID. The miniport driver must return NDIS_STATUS_NOT_ACCEPTED if it is currently associated.
When queried, this OID requests that the miniport driver return the NIC's current radio configuration.
This OID uses an NDIS_802_11_CONFIGURATION structure, which describes the configuration of a radio. This structure is defined as follows:
typedef struct _NDIS_802_11_CONFIGURATION {
ULONG Length;
ULONG BeaconPeriod;
ULONG ATIMWindow;
ULONG DSConfig;
NDIS_802_11_CONFIGURATION_FH FHConfig;
} NDIS_802_11_CONFIGURATION, *PNDIS_802_11_CONFIGURATION;
The members of this structure contain the following information:
Length
The length, in bytes, of the NDIS_802_11_CONFIGURATION structure.BeaconPeriod
The interval between beacon message transmissions. This value is specified in Kmicroseconds (1024 microseconds).For a set operation, BeaconPeriod specifies the beacon interval for ad hoc mode. BeaconPeriod is ignored in infrastructure mode.
For a query, the miniport driver returns a value for BeaconPeriod based on the following:
If the device is in infrastructure mode and is associated, the driver returns the current beacon period of the associated access point.
If the device is in ad hoc mode, the driver returns the IBSS beacon period.
If the device is not associated, the driver returns 0.
ATIMWindow
The announcement traffic information message (ATIM) window in Kmicroseconds (1024 microseconds). The ATIM window is a short time period immediately after the transmission of each beacon in an ad hoc network. During the ATIM window, any station within the ad hoc network can indicate the need to transfer data to another station during the following data-transmission window.If the driver's network mode is set for infrastructure networks, the driver returns 0 for ATIMWindow
DSConfig
The frequency, in kHz, of the selected channel.For a set operation, DSConfig specifies the frequency for ad hoc mode. The driver must ignore a setting of DSConfig for infrastructure mode.
For a query, DSConfig contains the current radio frequency.
For 2.4-GHz DSSS, 2.4-GHz OFDM, and 5-GHz OFDM radios, the miniport driver must return the current frequency as defined in the 802.11a specification.
The valid frequency ranges for DSConfig are from 2,412,000 through 2,484,000 for 2.4-GHz radios and from 5,000,000 through 6,000,000 for 5-GHz radios.
For example, the valid frequency subset in the United States for 5-GHz radios is from 5,180,000 through 5,240,000; from 5,260,000 through 5,320,000; and from 5,745,000 through 5,805,000.
FHConfig
The frequency hopping configuration in an NDIS_802_11_CONFIGURATION_FH structure.
The NDIS_802_11_CONFIGURATION_FH structure is defined as follows:
typedef struct _NDIS_802_11_CONFIGURATION_FH { ULONG Length;
ULONG HopPattern;
ULONG HopSet;
ULONG DwellTime;
} NDIS_802_11_CONFIGURATION_FH, *PNDIS_802_11_CONFIGURATION_FH;
The members of this structure contain the following information:
Length
The length, in bytes, of the NDIS_802_11_CONFIGURATION_FH structure.Note If the device does not support the Ndis802_11FH network type, the miniport driver must set Length to zero.
HopPattern
Specifies the hop pattern that is used to determine the hop sequence. As defined by the IEEE 802.11 standard, the Layer Management Entity (LME) of the physical layer uses a hop pattern to determine the hop sequence.HopSet
Specifies a set of patterns. The LME of the physical layer uses these patterns to determine the hop sequence.DwellTime
The maximum period of time during which the transmitter can remain fixed on a channel. This interval is described in Kmicroseconds (1024 microseconds).