estrutura WWAN_PACKET_SERVICE (wwan.h)
A estrutura WWAN_PACKET_SERVICE representa o estado do anexo do serviço de pacote 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 de 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 pacote 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 WwanDataClass membro 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 do 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 miniporto devem definir esse membro como WWAN_DATA_CLASS_CUSTOM se a classe de dados não for um dos valores predefinidos no WwanDataClass membro 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 é usado apenas para NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
CurrentTai
Uma estrutura de WWAN_SINGLE_TAI que representa a TAI (Identidade de Área de Acompanhamento) atual. Esse campo é usado apenas para NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
Rel3GppVer
0xFFFFFFFF será usado se 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.
Observações
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 no 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 dá suporte a uma classe de dados que não seja os valores predefinidos no WwanDataClass membro do WWAN_DEVICE_CAPS, o driver de miniporto deverá definir o sinalizador WWAN_DATA_CLASS_CUSTOM junto com a máscara de bits apropriada definida para a classe de dados neste membro.
de Consulta 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 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" em MB de Semântica Operacional mostra os valores de falha de código de causa de anexação de pacotes ou pacotes definidos no de Especificação 3GPP TS 24.008 do.
Os pontos a seguir fornecem diretrizes sobre como retornar um erro específico 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 miniport devem retornar o erro específico da rede em resposta a consulta solicitações. Nesse caso, os drivers de miniporto devem definir o uStatus membro da estrutura NDIS_WWAN_PACKET_SERVICE_STATE para WWAN_STATUS_SUCCESS e definir o membro uNwError para o código de erro específico da rede.
- Se um conjunto de solicitação falhar, os drivers de miniport devem retornar o código de erro específico da rede. Nesse caso, os drivers de miniporto devem definir o uStatus membro da estrutura NDIS_WWAN_PACKET_SERVICE_STATE para WWAN_STATUS_FAILURE e definir o membro uNwError para 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 para WWAN_STATUS_SUCCESS e definir o membro uNwError para o código de erro específico da rede.
Os drivers de miniporto devem relatar o código de causa o mais cedo 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 miniporto deverá denunciá-lo nesse momento.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 7 e versões posteriores do Windows. |
| cabeçalho | wwan.h (inclua Wwan.h) |