estructura DOT11_PHY_ID_LIST (windot11.h)

  • Artículo
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 dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.
 
La estructura DOT11_PHY_ID_LIST especifica una lista de cero o más tipos PHY.

Sintaxis

typedef struct DOT11_PHY_ID_LIST {
  NDIS_OBJECT_HEADER Header;
  ULONG              uNumOfEntries;
  ULONG              uTotalNumOfEntries;
  ULONG              dot11PhyId[1];
} DOT11_PHY_ID_LIST, *PDOT11_PHY_ID_LIST;

Miembros

Header

Tipo, revisión y tamaño de la estructura DOT11_PHY_ID_LIST. Este miembro tiene el formato de estructura NDIS_OBJECT_HEADER .

El controlador de minipuerto debe establecer los miembros de Header en los valores siguientes:

Tipo

Este miembro debe establecerse en NDIS_OBJECT_TYPE_DEFAULT.

Revisión

Este miembro debe establecerse en DOT11_PHY_ID_LIST_REVISION_1.

Size

Este miembro debe establecerse en sizeof(DOT11_PHY_ID_LIST).

Para obtener más información sobre estos miembros, vea NDIS_OBJECT_HEADER.

uNumOfEntries

Número de entradas de la matriz dot11PhyId .

uTotalNumOfEntries

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

dot11PhyId[1]

La lista de identificadores PHY (identificadores).

Comentarios

Un PHY ID en la matriz dot11PhyId debe ser uno de los siguientes:

  • Índice en la tabla de PHY admitidos que se definen en el objeto Operational msDot11 Operational msDot11 Operational msDot11SupportedPhyTypes management base (MIB) de Native 802.11. Para obtener más información sobre los identificadores PHY y el objeto MIB msDot11SupportedPhyTypes , vea OID_DOT11_SUPPORTED_PHY_TYPES.
  • Identificador PHY con el valor de DOT11_PHY_ID_ANY. Este PHY ID se denomina PHY ID de carácter comodín y se usa para especificar cualquier PHY compatible en la estación 802.11. Si se usa el id. de PHY comodín, debe ser la única entrada de la matriz dot11PhyId .
Un controlador de minipuerto devuelve la estructura DOT11_PHY_ID_LIST cuando se consulta mediante OID_DOT11_ACTIVE_PHY_LIST o OID_DOT11_DESIRED_PHY_LIST.

Cuando se consultan estos OID, el controlador de minipuerto debe comprobar que el miembro InformationBuffer del parámetro OidRequest de la función MiniportOidRequest es lo suficientemente grande como para devolver toda la estructura de DOT11_PHY_ID_LIST, incluidas todas las entradas de la matriz dot11PhyId. 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_PHY_ID_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 dot11PhyId .
    • 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.
    • Produzca 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_PHY_ID_LIST, el controlador de minipuerto debe hacer lo siguiente para completar una solicitud de consulta correcta:
    • Para la estructura DOT11_PHY_ID_LIST, establezca los miembros uNumOfEntries y uTotalNumOfEntries en el número total de entradas de la matriz dot11PhyId .
    • 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_PHY_ID_LIST. El controlador de minipuerto también debe copiar toda la estructura de DOT11_PHY_ID_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

OID_DOT11_ACTIVE_PHY_LIST

OID_DOT11_DESIRED_PHY_LIST

NDIS_OBJECT_HEADER