OID_DOT11_CIPHER_DEFAULT_KEY_ID (Compact 7)
3/12/2014
When set, the OID_DOT11_CIPHER_DEFAULT_KEY_ID object identifier (OID) requests that the miniport driver set the value of the Extensible Station (ExtSTA) dot11DefaultKeyID management information base (MIB) object to the specified value.
When queried, this OID requests that the miniport driver return the value of the dot11DefaultKeyID MIB object.
The dot11DefaultKeyID MIB object specifies the index of a cipher key in the 802.11 station’s default key table that the station uses for data encryption. The 802.11 station uses the cipher key referenced by the dot11DefaultKeyID MIB object as the default encryption key for transmitted packets unless a key-mapping key exists for the destination media access control (MAC) address.
Note
Support for this OID is mandatory if the 802.11 station supports any cipher algorithms. The miniport driver returns a list of supported cipher algorithms when OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR or OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR are queried.
The data type for this OID is a ULONG value. For standard 802.11 cipher algorithms, the default key ID must be from 0 through 3. For a cipher algorithm developed by an IHV, the default key ID can be any value within the range that is defined by the IHV.
The IEEE 802.11-1999 standard defines key index values from 1 through 4. The value x specified by this OID maps to the 802.11 key index (x + 1).
When transmitting 802.11 data, the 802.11 station encrypts the MAC service data unit (MSDU) payload data by using the cipher key that is referenced by the dot11DefaultKeyID MIB object if the following are true:
- The basic service set (BSS) network has enabled encryption
- A key mapping key does not exist for the destination MAC address. For more information about key-mapping keys, see OID_DOT11_CIPHER_KEY_MAPPING_KEY.
When OID_DOT11_CIPHER_DEFAULT_KEY_ID is set, the 802.11 station must synchronize the change to the default key ID with its packet-processing path. When the default key ID is changed, the 802.11 station must use it to encrypt the next MAC protocol data unit (MPDU) data frame that it transmits.
The default value of the dot11DefaultKeyID MIB object is zero. 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
Header |
windot11.h |
See Also
Reference
Native 802.11 Extensible Station OIDs
OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR
OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR
OID_DOT11_CIPHER_KEY_MAPPING_KEY
MiniportInitializeEx
OID_DOT11_RESET_REQUEST
DOT11_RESET_REQUEST
Native 802.11 Wireless LAN OIDs