estrutura WWAN_PACKET_SERVICE (wwan.h)
A estrutura WWAN_PACKET_SERVICE representa o estado do anexo do serviço de pacotes do dispositivo MB.
Sintaxe
typedef struct _WWAN_PACKET_SERVICE {
ULONG uNwError;
WWAN_PACKET_SERVICE_STATE PacketServiceState;
ULONG AvailableDataClass;
ULONG CurrentDataClass;
WWAN_5G_FREQUENCY_RANGE FrequencyRange;
ULONG CurrentDataSubClass;
WWAN_SINGLE_TAI CurrentTai;
ULONG Rel3GppVer;
} WWAN_PACKET_SERVICE, *PWWAN_PACKET_SERVICE;
Membros
uNwError
Um erro específico da rede, no caso de uma falha de anexação de pacote ou desanexação de pacotes. Para obter mais informações sobre esse membro, consulte a seção "Comentários" a seguir.
PacketServiceState
O estado do serviço de pacotes do dispositivo.
AvailableDataClass
Um bitmap que representa quais classes de dados estão disponíveis para o dispositivo na rede atual. Para obter uma lista detalhada de valores, consulte o membro WwanDataClass do WWAN_DEVICE_CAPS.
Os drivers de miniporto devem definir esse membro como WWAN_DATA_CLASS_NONE quando o dispositivo não estiver registrado em uma rede ou quando não houver classe de dados ou quando a classe de dados com suporte não estiver disponível. Os drivers de miniporto devem definir esse membro com um valor válido quando o dispositivo é registrado em uma rede.
CurrentDataClass
Um único valor do membro WwanDataClass no WWAN_DEVICE_CAPS que representa qual classe de dados está sendo usada no momento pelo dispositivo.
Para todos os serviços de dados, exceto HSPA, os drivers de miniporto devem definir esse membro como um único valor WWAN_DATA_CLASS_XXX. Para serviços de dados HSPA, os drivers de miniporto devem especificar um OR bit a bit de WWAN_DATA_CLASS_HSDPA e WWAN_DATA_CLASS_HSUPA.
Os drivers de miniport devem definir esse membro com um valor válido e enviar a notificação apropriada quando o dispositivo alterar os serviços, por exemplo, de 1xRTT para 1xEV-DO.
Os drivers de miniport devem definir esse membro como WWAN_DATA_CLASS_CUSTOM se a classe de dados não for um dos valores predefinidos no membro WwanDataClass do WWAN_DEVICE_CAPS.
FrequencyRange
Um valor WWAN_5G_FREQUENCY_RANGE que especifica os intervalos de frequência que o dispositivo está usando. Esse membro só será válido se CurrentDataClass for WWAN_DATA_CLASS_5G_NSA ou WWAN_DATA_CLASS_SA.
CurrentDataSubClass
Esse campo só é usado para NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
CurrentTai
Uma estrutura WWAN_SINGLE_TAI que representa a TAI (Identidade de Área de Rastreamento) atual. Esse campo só é usado para NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
Rel3GppVer
0xFFFFFFFF será usado se for desconhecido. Desconhecido significa que MBIM_TLV_TYPE_3GPP_REL_VERSION não está contido em MBIM_PACKET_SERVICE_INFO_V3, o dispositivo retorna diretamente 0xFFFFFFFF ou o dispositivo está usando o MBIM 3.0 ou mais antigo.
Comentários
O estado atual do serviço de anexação de pacotes normalmente é refletido na interface do usuário do dispositivo.
O Serviço MB combina as classes de dados representadas em AvailableDataClass com as classes de dados com suporte que são relatadas com os recursos do dispositivo para exibir a interseção das opções disponíveis para o usuário.
Se um dispositivo também oferecer suporte a uma classe de dados que não seja os valores predefinidos no membro WwanDataClass do WWAN_DEVICE_CAPS, o driver de miniporto deverá definir o sinalizador WWAN_DATA_CLASS_CUSTOM juntamente com a máscara de bits apropriada definida para a classe de dados nesse membro.
Consultar e definir solicitações OID, bem como eventos de status não solicitados, usam o membro uNwError. Se não houver nenhum erro específico de rede ou se o erro específico da rede não for conhecido, os drivers de miniporto deverão definir esse membro como zero. A seção "Estrutura de Indicação de Status" na Semântica Operacional do MB mostra os valores de falha de código de causa de anexação de pacote ou de desanexação de pacotes definidos na Especificação 3GPP TS 24.008.
Os seguintes pontos fornecem diretrizes sobre como retornar erros específicos de rede em diferentes cenários:
- Se a operação de anexação de pacotes falhar devido a um erro específico de rede, os drivers de miniporto deverão retornar o erro específico da rede em resposta às solicitações de consulta . Nesse caso, os drivers de miniporto devem definir o membro uStatus da estrutura NDIS_WWAN_PACKET_SERVICE_STATE como WWAN_STATUS_SUCCESS e definir o membro uNwError como o código de erro específico da rede.
- Se uma solicitação definida falhar, os drivers de miniporto deverão retornar o código de erro específico da rede. Nesse caso, os drivers de miniporto devem definir o membro uStatus da estrutura NDIS_WWAN_PACKET_SERVICE_STATE como WWAN_STATUS_FAILURE e definir o membro uNwError como o código de erro específico da rede.
- Sempre que o estado de registro do dispositivo for alterado porque o pacote de rede desanexa o dispositivo, os eventos de status não solicitados devem incluir o erro específico da rede. Nesse caso, o driver de miniporto deve definir o membro uStatus da estrutura NDIS_WWAN_PACKET_SERVICE_STATE como WWAN_STATUS_SUCCESS e definir o membro uNwError como o código de erro específico da rede.
Os drivers de miniport devem relatar o código de causa na instância mais antiga possível. Por exemplo, se o dispositivo MB encontrar um desses códigos ao tentar registrar o dispositivo com um provedor de rede, o driver de miniporte deverá reportá-lo nesse momento.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 7 e versões posteriores do Windows. |
| Cabeçalho | wwan.h (inclua Wwan.h) |