OID_802_11_SSID

When set, the OID_802_11_SSID OID requests that the miniport driver set the service set identifier (SSID) of the BSS with which the device can associate.

When queried, this OID requests that the miniport driver return the SSID with which the device is associated. The miniport driver returns zero for the SsidLength member if the device is not associated with an SSID.

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



    typedef struct _NDIS_802_11_SSID {
         ULONG SsidLength;
         UCHAR Ssid[32];
 
    } NDIS_802_11_SSID,   *PNDIS_802_11_SSID;
  


The members of this structure contain the following information:

SsidLength

The length of the Ssid member in bytes.

Ssid

The SSID. The SSID string is not null-terminated and is case sensitive.

An empty string (that is, a string with SsidLength set to zero) requests that the device associate with any available SSID.

The SSID is a string that identifies a set of interconnected basic service sets (BSSs). If the string is of zero length (empty), the device can associate with any available SSID.

If the SSID is available for multiple radio types (for example, IEEE 802.11a, IEEE 802.11b, and IEEE 802.11g), the miniport driver must use the radio type specified from a prior setting of the OID_802_11_NETWORK_TYPE_IN_USEOID. Otherwise, if the OID_802_11_NETWORK_TYPE_IN_USE OID was not previously set or the radio type is set to Ndis802_11Automode, the miniport driver can determine the best radio type to use (for example, by examining the radio signal strength and the system battery life).

Setting an SSID results in the following actions:

  • Powering on the radio if the radio is powered off through a setting of OID_802_11_DISASSOCIATE.

    Note   If the radio has been powered off through a hardware or software setting, the driver must not power the radio on when OID_802_11_SSID is set. Instead, the driver must fail the set request and return NDIS_STATUS_ADAPTER_NOT_READY.

  • Setting the desired SSID with the specified value, or setting it to any available SSID if the specified value has a length of zero.

  • If the associated SSID is different from the desired SSID, the device must disassociate from that SSID. After the device is disassociated, the driver must make a media disconnect indication.

  • Attempting to associate the device with the SSID.

  • If the associated SSID is the same as the desired SSID, the device must either reassociate with the same access point or associate with a different access point within the desired SSID.

    Note   The driver must not make a media disconnect indication if the associated SSID is the same as the desired SSID.

  • After the device associates with any access point within the desired SSID, the miniport driver must make a media connect indication.

When associating with the desired SSID, the miniport driver must follow the media sense rules when making media connect or disconnect indications. These rules are described in Media Status Indications for 802.11 Networks.

For NDIS 6.0 and later, the miniport driver must not associate with any SSID until this OID is set.

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft