NDIS_STATUS_DOT11_PMKID_CANDIDATE_LIST (Compact 2013)

3/26/2014

A miniport driver uses the NDIS_STATUS_DOT11_PMKID_CANDIDATE_LIST indication to request pairwise master key identifiers (PMKIDs) for basic service set (BSS) identifiers (BSSIDs) to which the 802.11 station can roam. When roaming, the 802.11 station uses the PMKID value to pre-authenticate with an access point (AP).

The data type for this indication is the DOT11_PMKID_CANDIDATE_LIST_PARAMETERS structure.

Pre-authentication applies to infrastructure networks that support Robust Security Network Association (RSNA) authentication. For more information about RSNA authentication, refer to Clause 8.4.6 of the IEEE 802.11i-2004 standard.

The miniport driver calls NdisMIndicateStatusEx to make an NDIS_STATUS_DOT11_PMKID_CANDIDATE_LIST indication, and must pass a pointer to an NDIS_STATUS_INDICATION structure through the StatusIndication parameter. When it makes this indication, the driver must set the following members of the NDIS_STATUS_INDICATION structure:

• StatusCode must be set to NDIS_STATUS_DOT11_PMKID_CANDIDATE_LIST
• StatusBuffer must be set to the address of a DOT11_LINK_QUALITY_PARAMETERS structure
• StatusBufferSize must be set to sizeof(DOT11_PMKID_CANDIDATE_LIST_PARAMETERS) plus the values of the uCandidateListSize and uCandidateListoffset members

The miniport driver can make the NDIS_STATUS_DOT11_PMKID_CANDIDATE_LIST indication only if:

• The IEEE 802.11 dot11DesiredBSSType MIB object is set to dot11_BSS_type_infrastructure. For more information about this MIB object, see OID_DOT11_DESIRED_BSS_TYPE.
• The 802.11 station has associated with a BSS that supports RSNA authentication

When it makes the NDIS_STATUS_DOT11_PMKID_CANDIDATE_LIST indication, the miniport driver must do the following:

• Order the PMKID candidate list from preferred to least preferred
  The miniport driver can use any criteria to define the preference order. For example, the miniport driver can order the PMKID candidate list based on RSSI strength.
• Set the number of entries in the PMKID candidate list to a value less than or equal to the value of uPMKIDCacheSize. This the driver returned when OID_DOT11_EXTSTA_CAPABILITY was previously queried.
• Be associated with an RSNA-capable AP and have transferred cipher keys to the 802.11 station through set requests of OID_DOT11_CIPHER_DEFAULT_KEY or OID_DOT11_CIPHER_KEY_MAPPING_KEY.

When the 802.11 station is associated with the AP, the miniport driver can generate additional NDIS_STATUS_DOT11_PMKID_CANDIDATE_LIST indications if the BSSID candidate list changes. The driver should keep the frequency of these indications to a minimum. For example, the driver should not make an NDIS_STATUS_DOT11_PMKID_CANDIDATE_LIST indication if only one new entry was added to its BSSID candidate list. Instead, it must make the indication after the number of new entries inserted into its BSSID candidate list reaches a driver-specific threshold.

See Also

Reference

Native 802.11 Extensible Station Status Indications
DOT11_PMKID_CANDIDATE_LIST_PARAMETERS
NdisMIndicateStatusEx
NDIS_STATUS_INDICATION
NDIS_STATUS_DOT11_PMKID_CANDIDATE_LIST
DOT11_LINK_QUALITY_PARAMETERS
OID_DOT11_DESIRED_BSS_TYPE
OID_DOT11_EXTSTA_CAPABILITY
OID_DOT11_CIPHER_DEFAULT_KEY
OID_DOT11_CIPHER_KEY_MAPPING_KEY
Native 802.11 Wireless LAN Status Indications