estrutura DOT11_PHY_ID_LIST (windot11.h)

  • Artigo
Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte Modelo de driver universal do Windows da WLAN.
 
A estrutura DOT11_PHY_ID_LIST especifica uma lista de zero ou mais tipos de PHY.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura DOT11_PHY_ID_LIST. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O driver de miniporta deve definir os membros de Header para os seguintes valores:

Tipo

Esse membro deve ser definido como NDIS_OBJECT_TYPE_DEFAULT.

Revisão

Esse membro deve ser definido como DOT11_PHY_ID_LIST_REVISION_1.

Tamanho

Esse membro deve ser definido como sizeof(DOT11_PHY_ID_LIST).

Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.

uNumOfEntries

O número de entradas na matriz dot11PhyId .

uTotalNumOfEntries

O número máximo de entradas que a matriz dot11PhyId pode conter.

dot11PhyId[1]

A lista de identificadores PHY (IDs).

Comentários

Uma ID de PHY na matriz dot11PhyId deve ser uma das seguintes:

  • Um índice na tabela de PHYs com suporte definido pelo objeto MIB (base de informações de gerenciamento) do Native 802.11 Operational msDot11SupportedPhyTypes . Para obter mais informações sobre IDs PHY e o objeto MIB msDot11SupportedPhyTypes , consulte OID_DOT11_SUPPORTED_PHY_TYPES.
  • Uma ID de PHY com o valor de DOT11_PHY_ID_ANY. Essa ID de PHY é chamada de ID PHY curinga e é usada para especificar qualquer PHY com suporte na estação 802.11. Se a ID PHY curinga for usada, ela deverá ser a única entrada na matriz dot11PhyId .
Um driver de miniporta retorna a estrutura DOT11_PHY_ID_LIST quando consultado por OID_DOT11_ACTIVE_PHY_LIST ou OID_DOT11_DESIRED_PHY_LIST.

Quando esses OIDs são consultados, o driver de miniporto deve verificar se o membro InformationBuffer do parâmetro OidRequest da função MiniportOidRequest é grande o suficiente para retornar toda a estrutura DOT11_PHY_ID_LIST, incluindo todas as entradas na matriz dot11PhyId. O valor do membro InformationBufferLength do parâmetro OidRequest determina o que o driver de miniporto deve fazer, como mostra a lista a seguir:

  • Se o valor do membro InformationBufferLength for menor que o comprimento, em bytes, de toda a estrutura DOT11_PHY_ID_LIST, o driver de miniporto deverá fazer o seguinte:
    • Defina o membro uNumOfEntries como zero.
    • Defina o membro uTotalNumOfEntries como o número de entradas na matriz dot11PhyId .
    • Para o parâmetro OidRequest , defina o membro BytesWritten como zero e o membro BytesNeeded para o comprimento, em bytes, de toda a estrutura DOT11_PHY_ID_LIST.
    • Falha na solicitação de consulta retornando NDIS_STATUS_BUFFER_OVERFLOW de sua função MiniportOidRequest .
  • Se o valor do membro InformationBufferLength for maior ou igual ao comprimento, em bytes, de toda a estrutura DOT11_PHY_ID_LIST, o driver de miniporto deverá fazer o seguinte para concluir uma solicitação de consulta bem-sucedida:
    • Para a estrutura DOT11_PHY_ID_LIST, defina os membros uNumOfEntries e uTotalNumOfEntries como o número total de entradas na matriz dot11PhyId .
    • Para o parâmetro OidRequest , defina o membro BytesNeeded como zero e o membro BytesWritten para o comprimento, em bytes, de toda a estrutura DOT11_PHY_ID_LIST. O driver de miniporta também deve copiar toda a estrutura DOT11_PHY_ID_LIST para o membro InformationBuffer .
    • Retorne NDIS_STATUS_SUCCESS de sua função MiniportOidRequest .

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho windot11.h (inclua Ndis.h)

Confira também

OID_DOT11_ACTIVE_PHY_LIST

OID_DOT11_DESIRED_PHY_LIST

NDIS_OBJECT_HEADER