OID_802_11_TEST

When set, the OID_802_11_TEST OID requests that the miniport driver perform a specified test. This OID must never be used during normal operation.

The data for this OID is specified in an NDIS_802_11_TEST structure, which is defined as follows:

typedef struct _NDIS_802_11_TEST {         ULONG Length;
         ULONG Type;
 union { struct _AuthenticationEvent {         NDIS_802_11_STATUS_TYPE StatusType;
         NDIS_802_11_AUTHENTICATION_REQUEST Request[1];
 } AuthenticationEvent;         NDIS_802_11_RSSI RssiTrigger;
 }; } NDIS_802_11_TEST, *PNDIS_802_11_TEST;

This structure includes the following members:

• Length
  The length, in bytes, of the NDIS_802_11_TEST structure and any additional data specific to the test action.

  Note   If the Type member is set to 1 (authentication indication test), then the Length member is set to the length of the NDIS_802_11_TEST structure plus the length, in bytes, of the number of NDIS_802_11_AUTHENTICATION_REQUEST elements within the Request member.

   

• Type
  Specifies the test action. The following values are defined:

  • 1: Authentication indication test.

  • 2 : RSSI indication test.

  For other values, the miniport driver must fail the set request and return NDIS_STATUS_INVALID_DATA.

• AuthenticationEvent
  Specifies the status type and request array that the miniport driver must use in the status indication. This member is only valid if the Type member has a value of 1.

  This structure includes the following members:

  • StatusType
    Specifies the status type for the indication. This is set to Ndis802_11StatusType_Authentication for an authentication event.

  • Request
    An array of NDIS_802_11_AUTHENTICATION_REQUEST structures.

• RssiTrigger
  An NDIS_802_11_RSSI structure. This member is only valid if the Type member has a value of 2.

  Note  RssiTrigger is used to test the generation of an RSSI indication. The driver must generate this indication when set by this OID regardless of any prior set of OID_802_11_RSSI_TRIGGER.

   

When Typehas a value of 1, the miniport driver is requested to make an authentication indication. It does this by calling NdisMIndicateStatuswith the parameters set as follows:

• The GeneralStatus parameter is set to NDIS_STATUS_MEDIA_SPECIFIC_INDICATION.

• The StatusBuffer parameter is set to the address of the StatusType member within the OID's InformationBuffer parameter.

• The StatusBufferSize parameter is set to the value of ( Length- 8).

When Typehas a value of 2, the miniport driver is requested to make an RSSI indication. It does this by calling NdisMIndicateStatuswith the parameters set as follows:

• The GeneralStatus parameter is set to NDIS_STATUS_MEDIA_SPECIFIC_INDICATION.

• The StatusBuffer parameter is set to the address of the RssiTrigger member within the OID's InformationBuffer parameter.

• The StatusBufferSize parameter is set to the value of sizeof(NDIS_802_11_RSSI).

Note   The driver must call NdisMIndicateStatusComplete after the call to NdisMIndicateStatus.

For more information about media-specific indications for 802.11 devices, see 802.11 Media-Specific Status Indications.

Send comments about this topic to Microsoft