DOT11_CIPHER_ALGORITHM_LIST structure

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.
 
The DOT11_CIPHER_ALGORITHM_LIST structure defines a list of DOT11_CIPHER_ALGORITHM structures that can be enabled on the 802.11 station.

Syntax

typedef struct DOT11_CIPHER_ALGORITHM_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_CIPHER_ALGORITHM AlgorithmIds[1];
} DOT11_CIPHER_ALGORITHM_LIST, *PDOT11_CIPHER_ALGORITHM_LIST;

Members

        `Header`

        The type, revision, and size of the DOT11_CIPHER_ALGORITHM_LIST structure. This member is
 formatted as an
 <a href="..\ntddndis\ns-ntddndis-_ndis_object_header.md">NDIS_OBJECT_HEADER</a> structure.

The miniport driver must set the members of Header to the following values:

Type

This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision

This member must be set to DOT11_CIPHER_ALGORITHM_LIST_REVISION_1.

Size

This member must be set to sizeof(DOT11_CIPHER_ALGORITHM_LIST).

For more information about these members, see NDIS_OBJECT_HEADER.

        `uNumOfEntries`

        The number of entries in the
 <b>AlgorithmIds</b> array.
    
    
        `uTotalNumOfEntries`

        The maximum number of entries that the
 <b>AlgorithmIds</b> array can contain.
    
    
        `AlgorithmIds`

        The cipher algorithm, which is defined by a
 <a href="..\wlantypes\ne-wlantypes-_dot11_cipher_algorithm.md">DOT11_CIPHER_ALGORITHM</a> enumerator
 value.

The list of cipher algorithms is sorted by preference. AlgorithmIds [0] defines the cipher algorithm with the highest preference.

## Remarks
    A miniport driver returns the DOT11_CIPHER_ALGORITHM_LIST structure when it is queried by either
<a href="https://docs.microsoft.com/previous-versions/windows/embedded/gg157261(v=winembedded.80)">
OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR</a> or
<a href="https://docs.microsoft.com/windows-hardware/drivers/network/oid-dot11-supported-multicast-algorithm-pair">
OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR</a>.

When these OIDs are queried, the miniport driver must verify that the InformationBuffer member of the MiniportOidRequest function's OidRequest parameter is large enough to return the entire DOT11_CIPHER_ALGORITHM_LIST structure, including all entries in the AlgorithmIds array. The value of the InformationBufferLength member of the OidRequest parameter determines what the miniport driver must do, as the following list shows:

  • If the value of the InformationBufferLength member is less than the length, in bytes, of the entire DOT11_CIPHER_ALGORITHM_LIST structure, the miniport driver must do the following:
    • For the OidRequest parameter, set the BytesWritten member to zero and the BytesNeeded member to the length, in bytes, of the entire DOT11_CIPHER_ALGORITHM_LIST structure.
    • Fail the query request by returning NDIS_STATUS_BUFFER_OVERFLOW from its MiniportOidRequest function.
  • If the value of the InformationBufferLength member is greater than or equal to the length, in bytes, of the entire DOT11_CIPHER_ALGORITHM_LIST structure, the miniport driver must do the following to complete a successful query request:
    • For the DOT11_CIPHER_ALGORITHM_LIST structure, set the uNumOfEntries and uTotalNumOfEntries members to the total number of entries in the AlgorithmIds array.
    • For the OidRequest parameter, set the BytesNeeded member to zero and the BytesWritten member to the length, in bytes, of the entire DOT11_CIPHER_ALGORITHM_LIST structure. The miniport driver must also copy the entire DOT11_CIPHER_ALGORITHM_LIST structure to the
          <b>InformationBuffer</b> member.
      
    • Return NDIS_STATUS_SUCCESS from its MiniportOidRequest function.

Requirements

   
Minimum supported client Available starting with Windows Vista.
Header windot11.h (include Ndis.h)
## See Also

    <a href="https://docs.microsoft.com/previous-versions/windows/embedded/gg157261(v=winembedded.80)">

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR

OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

NDIS_OBJECT_HEADER