estructura DOT11_PHY_ID_LIST (windot11.h)
Importante
WiFiCx es el nuevo modelo de controlador de Wi-Fi lanzado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes. El modelo de controlador WDI ahora está en modo de mantenimiento y solo recibirá correcciones de prioridad alta.
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 una estructura NDIS_OBJECT_HEADER.
El controlador de miniport debe establecer los miembros de Encabezado 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.
Tamaño
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 de dot11PhyId.
uTotalNumOfEntries
Número máximo de entradas que puede contener el matriz dot11PhyId.
dot11PhyId[1]
Lista de identificadores PHY (identificadores).
Observaciones
Un PHY ID en la matriz de dot11PhyId debe ser uno de los siguientes:
- Índice en la tabla de PHY admitidos definidos por el objeto De base de información de administración (MIB) de Native 802.11 Operational msDot11SupportedPhyTypes management information base (MIB). Para obtener más información sobre los identificadores PHY y los msDot11SupportedPhyTypes objeto MIB, consulte OID_DOT11_SUPPORTED_PHY_TYPES.
- Identificador PHY con el valor de DOT11_PHY_ID_ANY. Este PHY ID se denomina PHY ID 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 de dot11PhyId.
Cuando se consultan estos OID, el controlador de miniport debe comprobar que el InformationBuffer miembro del MiniportOidRequest función OidRequest parámetro es lo suficientemente grande como para devolver toda la estructura 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 miniport, como se muestra en la lista siguiente:
-
Si el valor del miembro informationBufferLength es menor que la longitud, en bytes, de toda la estructura DOT11_PHY_ID_LIST, el controlador de miniport debe hacer lo siguiente:
- Establezca el miembro uNumOfEntries en cero.
- Establezca el miembro uTotalNumOfEntries en el número de entradas de la matriz dot11PhyId de.
- Para el parámetro OidRequest, establezca el miembro BytesWritten en cero y el miembro BytesNeeded 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 informationBufferLength miembro es mayor o igual que la longitud, en bytes, de toda la estructura de DOT11_PHY_ID_LIST, el controlador de miniport debe hacer lo siguiente para completar una solicitud de consulta correcta:
- Para la estructura DOT11_PHY_ID_LIST, establezca los 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 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 de.
- Devuelve NDIS_STATUS_SUCCESS de su función de MiniportOidRequest.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| encabezado de | windot11.h (incluye Ndis.h) |