Share via

OID_802_11_ASSOCIATION_INFORMATION

  • Article

When queried, the OID_802_11_ASSOCIATION_INFORMATION OID requests that the miniport driver return the IEs that were used in the last association or reassociation request to an access point. The driver also returns the IEs in the last association or reassociation response from the access point.

The data type for this OID is the NDIS_802_11_ASSOCIATION_INFORMATION structure, which is defined as follows:

typedef struct _NDIS_802_11_ASSOCIATION_INFORMATION {         ULONG Length;
         USHORT AvailableRequestFixedIEs;
 struct _NDIS_802_11_AI_REQFI {         USHORT Capabilities;
         USHORT ListenInterval;
         NDIS_802_11_MAC_ADDRESS CurrentAPAddress;
   } RequestFixedIEs;         ULONG RequestIELength;
         ULONG OffsetRequestIEs;
         USHORT AvailableResponseFixedIEs;
 struct _NDIS_802_11_AI_RESFI {         USHORT Capabilities;
         USHORT StatusCode;
         USHORT AssociationId;
 } ResponseFixedIEs;         ULONG ResponseIELength;
         ULONG OffsetResponseIEs;
 } NDIS_802_11_ASSOCIATION_INFORMATION,

This structure includes the following members:

  • Length
    The length of the structure, in bytes. The value does not include any variable-length IEs that are included in the OID buffer.

  • AvailableRequestFixedIEs
    A bitmask of the elements that are available in the RequestFixedIEs member. This bitmask is defined as follows:

    #define NDIS_802_11_AI_REQFI_CAPABILITIES 1
#define NDIS_802_11_AI_REQFI_LISTENINTERVAL 2
#define NDIS_802_11_AI_REQFI_CURRENTAPADDRESS 4

    The NDIS_802_11_AI_REQFI_CAPABILITIES bit is set if the Capabilities IE is included in the member.

    The NDIS_802_11_AI_REQFI_LISTENINTERVAL bit is set if the ListenInterval IE is included in the RequestFixedIEs member.

    The NDIS_802_11_AI_REQFI_CURRENTAPADDRESS bit is set if the CurrentAPAddress IE is included in the RequestFixedIEs member.

  • RequestFixedIEs
    Specifies any fixed-length IEs from the association or reassociation request message.

    This member contains the fixed-length IEs that were in the last association or reassociation request. The CurrentAPAddress member is only valid in a reassociation request, so the driver will not include CurrentAPAddress if the last request was an association request. In this case, the driver will not set the NDIS_802_11_AI_REQFI_CURRENTAPADDRESS bit in AvailableRequestFixedIEs.

  • RequestIELength
    The number of bytes within the buffer that contains any variable-length IEs from the last association or reassociation request message. This value must be set to zero if a request has not been made.

  • OffsetRequestIEs
    The offset to the start of the buffer that contains any variable-length IEs from the association or reassociation request message.

    The OffsetRequestIEs member contains the IEs that were in the last association or reassociation request message. The request could have succeeded or failed.

    Note   The IEs must be in the OID's InformationBuffer immediately following the NDIS_802_11_ASSOCIATION_INFORMATION structure. OffsetRequestIEs is the offset from the start of the structure to the start of the IEs. In other words, the start of the IEs is calculated by adding the value of OffsetRequestIEs to the address of the start of the NDIS_802_11_ASSOCIATION_INFORMATION structure.

     

  • AvailableResponseFixedIEs
    A bitmask of the fixed-length IEs that are available in the ResponseFixedIEs structure. This bitmask is defined as follows:

    #define NDIS_802_11_AI_RESFI_CAPABILITIES 1
#define NDIS_802_11_AI_RESFI_STATUSCODE 2
#define NDIS_802_11_AI_RESFI_ASSOCIATIONID 4

    The NDIS_802_11_AI_RESFI_CAPABILITIES bit is set if the Capabilities IE is included in the ResponseFixedIEs member.

    The NDIS_802_11_AI_RESFI_STATUSCODE bit is set if the Status Code IE is included in the ResponseFixedIEs member.

    The NDIS_802_11_AI_RESFI_ASSOCIATIONID bit is set if the Association ID IE is included in the ResponseFixedIEs member..

  • ResponseFixedIEs
    Specifies any fixed-length IEs from the association or reassociation response message. If an association or reassociation response was received, the driver must return all three fixed-length IEs.

  • ResponseIELength
    The number of bytes within the buffer that contains any variable-length IEs from the last association or reassociation response message. This value must be zero if a response to the last association or reassociation request was not received.

  • OffsetResponseIEs
    The offset to the start of the buffer that contains any variable-length IEs from the association or reassociation response message. The buffer contains the IEs that were in the last association or reassociation response.

    Note   The IEs must be in the OID's InformationBuffer immediately following the NDIS_802_11_ASSOCIATION_INFORMATION structure. OffsetRequestIEs is the offset from the start of the structure to the start of the IEs. In other words, the start of the IEs is calculated by adding the value of OffsetRequestIEs to the address of the start of the NDIS_802_11_ASSOCIATION_INFORMATION structure.

     

 

 

Send comments about this topic to Microsoft