Compartir a través de


estructura DOT11_SUPPORTED_ANTENNA_LIST (windot11.h)

Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.
 
La estructura DOT11_SUPPORTED_ANTENNA_LIST especifica una lista de antenas que se pueden usar para las operaciones de recepción o transmisión.

Sintaxis

typedef struct _DOT11_SUPPORTED_ANTENNA_LIST {
  ULONG                   uNumOfEntries;
  ULONG                   uTotalNumOfEntries;
  DOT11_SUPPORTED_ANTENNA dot11SupportedAntenna[1];
} DOT11_SUPPORTED_ANTENNA_LIST, *PDOT11_SUPPORTED_ANTENNA_LIST;

Miembros

uNumOfEntries

Número de entradas de la matriz dot11SupportedAntenna . Un valor cero para el miembro uNumOfEntries indica una lista vacía.

uTotalNumOfEntries

Número máximo de entradas que puede contener la matriz dot11SupportedAntenna .

dot11SupportedAntenna[1]

Lista de antenas admitidas. Cada elemento de esta lista tiene el formato de DOT11_SUPPORTED_ANTENNA estructura.

Comentarios

Un controlador de minipuerto devuelve la estructura DOT11_SUPPORTED_ANTENNA_LIST cuando se consulta mediante cualquiera de las dos OID_DOT11_SUPPORTED_RX_ANTENNA o OID_DOT11_SUPPORTED_TX_ANTENNA.

Cuando se consultan estos OID, el controlador de minipuerto debe comprobar que el miembro InformationBuffer del parámetro OidRequest de la función OidRequest es lo suficientemente grande como para devolver toda la estructura de DOT11_SUPPORTED_ANTENNA_LIST, incluidas todas las entradas de la matriz dot11SupportedAntenna . El valor del miembro InformationBufferLength del parámetro OidRequest determina lo que debe hacer el controlador de minipuerto, como se muestra en la lista siguiente:

  • Si el valor del miembro InformationBufferLength es menor que la longitud, en bytes, de toda la estructura de DOT11_SUPPORTED_ANTENNA_LIST, el controlador de miniporte debe hacer lo siguiente:
    • Establezca el miembro uNumOfEntries en cero.
    • Establezca el miembro uTotalNumOfEntries en el número de entradas de la matriz dot11SupportedAntenna .

      Para el parámetro OidRequest , establezca el miembro BytesWritten en cero y el miembro BytesNeeded en la longitud, en bytes, de toda la estructura DOT11_PHY_ID_LIST.

    • Realice un error en la solicitud de consulta devolviendo NDIS_STATUS_BUFFER_OVERFLOW de su función MiniportOidRequest .
  • Si el valor del miembro InformationBufferLength es mayor o igual que la longitud, en bytes, de toda la estructura DOT11_SUPPORTED_ANTENNA_LIST, el controlador de miniporte debe hacer lo siguiente para completar una solicitud de consulta correcta:
    • Para la estructura DOT11_SUPPORTED_ANTENNA_LIST, establezca los miembros uNumOfEntries y uTotalNumOfEntries en el número total de entradas de la matriz dot11SupportedAntenna .
    • Para el parámetro OidRequest , establezca el miembro BytesNeeded en cero y el miembro BytesWritten en la longitud, en bytes, de toda la estructura DOT11_SUPPORTED_ANTENNA_LIST. El controlador de minipuerto también debe copiar toda la estructura de DOT11_SUPPORTED_ANTENNA_LIST en el miembro InformationBuffer .
    • Devuelve NDIS_STATUS_SUCCESS de su función MiniportOidRequest .

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado windot11.h (incluye Ndis.h)

Consulte también

DOT11_SUPPORTED_ANTENNA

OID_DOT11_SUPPORTED_TX_ANTENNA

OID_DOT11_SUPPORTED_RX_ANTENNA