estrutura WWAN_DEVICE_CAPS_EX_REV1 (wwan.h)

Artigo
08/08/2023

Importante

Comunicação livre de desvio

A Microsoft dá suporte a um ambiente diversificado e inclusivo. Este artigo contém referências à terminologia que o guia de estilo da Microsoft para comunicação sem preconceitos reconhece como excludente. A palavra ou frase é usada neste artigo para consistência porque ela aparece atualmente no software. Quando o software for atualizado para remover o idioma, este artigo será atualizado para estar em alinhamento.

A estrutura WWAN_DEVICE_CAPS_EX_REV1 representa os recursos de um dispositivo de banda larga móvel. WWAN_DEVICE_CAPS_EX_REV1 atualiza a estrutura de WWAN_DEVICE_CAPS_EX existente removendo os seguintes campos:

WwanSimClassBitMasks
WwanWCDMABandClass
WwanLTEBandClass
WwanNRBandClass
WwanMiscCaps

Sintaxe

typedef struct _WWAN_DEVICE_CAPS_EX_REV1 {
  WWAN_DEVICE_TYPE    WwanDeviceType;
  WWAN_CELLULAR_CLASS WwanCellularClass;
  WWAN_VOICE_CLASS    WwanVoiceClass;
  WWAN_SIM_CLASS      WwanSimClass;
  ULONG               WwanDataClass;
  WCHAR               CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN];
  ULONG               WwanGsmBandClass;
  ULONG               WwanCdmaBandClass;
  WCHAR               CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN];
  ULONG               WwanSmsCaps;
  ULONG               WwanControlCaps;
  WCHAR               DeviceId[WWAN_DEVICEID_LEN];
  WCHAR               Manufacturer[WWAN_MANUFACTURER_LEN];
  WCHAR               Model[WWAN_MODEL_LEN];
  WCHAR               FirmwareInfo[WWAN_FIRMWARE_LEN];
  ULONG               MaxActivatedContexts;
  ULONG               WwanAuthAlgoCaps;
  ULONG               ExecutorIndex;
  ULONG               WwanOptionalServiceCaps;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX_REV1, *PWWAN_DEVICE_CAPS_EX_REV1;

Membros

WwanDeviceType

O tipo do dispositivo. Os drivers de miniport devem definir o tipo de dispositivo como um valor diferente de WwanDeviceTypeUnknown.

WwanCellularClass

A classe celular do dispositivo. Os drivers de miniport devem definir a classe celular como um valor diferente de WwanCellularClassUnknown. Os valores neste controle de membros são específicos da tecnologia da rede celular, como modos de registro do provedor de rede.

Os drivers de miniport que dão suporte a vários modos devem definir isso como WwanCellularClassGsm.

WwanVoiceClass

A classe de voz do dispositivo. Esse membro informa ao Serviço MB sobre a presença do serviço de voz do circuito e como esse serviço interage com o serviço de dados. Lembre-se de que o Serviço MB não dá suporte à voz alternada por circuito nativamente, nem a impede. Cabe ao driver de miniporto determinar como dar suporte à voz do circuito. Esse membro WwanVoiceClass permite que o Serviço MB dê suporte a esse recurso no futuro.

WwanSimClass

A classe do Módulo de Identidade do Assinante (sim cartão). Os drivers de miniport devem definir a classe SIM como um valor diferente de WwanSimClassUnknown.

WwanDataClass

Um bitmap que representa as classes de dados compatíveis com o dispositivo. A tabela a seguir mostra os valores possíveis para esse membro.

Valor	Significado
WWAN_DATA_CLASS_NONE	O dispositivo não dá suporte ao serviço de dados.
WWAN_DATA_CLASS_GPRS	Há suporte para o serviço de dados GPRS (Serviço geral de Rádio de Pacotes). Esse valor se aplica somente a dispositivos baseados em GSM.
WWAN_DATA_CLASS_EDGE	Há suporte para o serviço de dados De Dados Avançados para Evolução Global (EDGE). Esse valor se aplica somente a dispositivos baseados em GSM.
WWAN_DATA_CLASS_UMTS	Há suporte para o serviço de dados UMTS (Sistema Universal de Telecomunicações Móveis). Esse valor se aplica somente a dispositivos baseados em GSM.
WWAN_DATA_CLASS_HSDPA	High-Speed serviço de dados HSDPA (Acesso a Pacotes de Downlink) tem suporte. Esse valor se aplica somente a dispositivos baseados em GSM.
WWAN_DATA_CLASS_HSUPA	High-Speed serviço de dados HSUPA (Uplink Packet Access). Esse valor se aplica somente a dispositivos baseados em GSM.
WWAN_DATA_CLASS_LTE	Há suporte para o serviço de dados LTE. Esse valor se aplica somente a dispositivos baseados em GSM.
WWAN_DATA_CLASS_5G	Há suporte para o serviço de dados 5G.
WWAN_DATA_CLASS_TDSCDMA	Há suporte para o serviço de dados CDMA síncrono da Divisão de Tempo.
WWAN_DATA_CLASS_1XRTT	Há suporte para o serviço de dados CDMA 1x Radio Transmission Technology (1xRTT, também conhecido como cdma2000, CDMA2000 1x e assim por diante). Esse valor se aplica somente a dispositivos baseados em CDMA.
WWAN_DATA_CLASS_1XEVDO	O CDMA Evolution-Data Otimizado (originalmente Somente Dados, 1xEDVO, também conhecido como CDMA2000 serviço de dados 1x EV-DO ou 1x EVDO). Esse valor se aplica somente a dispositivos baseados em CDMA.
WWAN_DATA_CLASS_1XEVDO_REVA	Há suporte para o serviço de dados 1xEVDO RevA. Esse valor se aplica somente a dispositivos baseados em CDMA.
WWAN_DATA_CLASS_1XEVDV	O serviço de dados CDMA Evolution-Data/Voice (também conhecido como CDMA 2000 1x EV-DV ou 1x EVDV) tem suporte. Esse valor se aplica somente a dispositivos baseados em CDMA.
WWAN_DATA_CLASS_3XRTT	Há suporte para o serviço de dados CDMA 3x Radio Transmission Technology (3xRTT). Esse valor se aplica somente a dispositivos baseados em CDMA.
WWAN_DATA_CLASS_1XEVDO_REVB	Há suporte para o serviço de dados 1xEVDO RevB. Esse valor se aplica somente a dispositivos baseados em CDMA.
WWAN_DATA_CLASS_UMB	Há suporte para o serviço de dados UMB. Esse valor se aplica somente a dispositivos baseados em CDMA.
WWAN_DATA_CLASS_CUSTOM	O dispositivo dá suporte a um serviço de dados não listado nesta tabela.

CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]

Uma cadeia de caracteres terminada em NULL que representa o nome da classe de dados personalizada. Esse membro só é válido quando o driver de miniporto define o bit WWAN_DATA_CLASS_CUSTOM no membro WwanDataClass .

WwanGsmBandClass

Um bitmap que representa as faixas de frequência compatíveis com dispositivos baseados em GSM. A tabela a seguir mostra os valores possíveis para esse membro.

Valor	Significado
WWAN_BAND_CLASS_UNKNOWN	A faixa de frequência compatível com o dispositivo não é fornecida.
WWAN_BAND_CLASS_I	O dispositivo dá suporte ao espectro UMTS2100.
WWAN_BAND_CLASS_II	O dispositivo dá suporte ao espectro UMTS1900.
WWAN_BAND_CLASS_III	O dispositivo dá suporte ao espectro UMTS1800.
WWAN_BAND_CLASS_IV	O dispositivo dá suporte ao espectro da AWS.
WWAN_BAND_CLASS_V	O dispositivo dá suporte ao espectro UMTS850.
WWAN_BAND_CLASS_VI	O dispositivo dá suporte ao espectro UMTS800.
WWAN_BAND_CLASS_VII	O dispositivo dá suporte ao espectro UMTS2600.
WWAN_BAND_CLASS_VIII	O dispositivo dá suporte ao espectro UMTS900.
WWAN_BAND_CLASS_IX	O dispositivo dá suporte ao espectro UMTS1700.
WWAN_BAND_CLASS_X
WWAN_BAND_CLASS_CUSTOM	O dispositivo dá suporte a um espectro diferente daqueles listados nesta tabela.

Se o driver de miniporto especificar WWAN_BAND_CLASS_CUSTOM, ele também deverá fornecer o nome da classe de dados em CustomBandClass.

Para obter mais informações sobre esses valores, consulte OID_WWAN_DEVICE_CAPS.

WwanCdmaBandClass

Um bitmap que representa as faixas de frequência compatíveis com dispositivos baseados em CDMA. A tabela a seguir mostra os valores possíveis para esse membro.

Valor	Significado
WWAN_BAND_CLASS_UNKNOWN	A faixa de frequência compatível com o dispositivo não é fornecida.
WWAN_BAND_CLASS_0	O dispositivo dá suporte à banda de 800MHz.
WWAN_BAND_CLASS_I	O dispositivo dá suporte à banda de 1900MHz.
WWAN_BAND_CLASS_II	O dispositivo dá suporte à banda TACS.
WWAN_BAND_CLASS_III	O dispositivo dá suporte à banda JTACS.
WWAN_BAND_CLASS_IV	O dispositivo dá suporte à banda de PCS coreano.
WWAN_BAND_CLASS_V	O dispositivo dá suporte à banda de 450 MHz.
WWAN_BAND_CLASS_VI	O dispositivo dá suporte à banda de 2 GHz.
WWAN_BAND_CLASS_VII	O dispositivo dá suporte à banda de 700 MHz.
WWAN_BAND_CLASS_VIII	O dispositivo dá suporte à banda de 1800 MHz.
WWAN_BAND_CLASS_IX	O dispositivo dá suporte à banda de 900 MHz.
WWAN_BAND_CLASS_X	O dispositivo dá suporte à banda secundária de 800 MHz.
WWAN_BAND_CLASS_XI	O dispositivo dá suporte à banda PAMR europeia de 400 MHz.
WWAN_BAND_CLASS_XII	O dispositivo dá suporte à banda PAMR de 800 MHz.
WWAN_BAND_CLASS_XIII	O dispositivo dá suporte à faixa de extensão de 2,5 GHz IMT2000.
WWAN_BAND_CLASS_XIV	O dispositivo dá suporte à banda PCS 1.9GHz dos EUA.
WWAN_BAND_CLASS_XV	O dispositivo dá suporte à banda AWS.
WWAN_BAND_CLASS_XVI	O dispositivo dá suporte à banda de US$ 2,5 GHz.
WWAN_BAND_CLASS_XVII	O dispositivo dá suporte à banda somente link de encaminhamento de 2,5 GHz dos EUA.
WWAN_BAND_CLASS_CUSTOM	O dispositivo dá suporte a uma banda diferente das faixas listadas nesta tabela.

Se o driver de miniporto especificar WWAN_BAND_CLASS_CUSTOM, ele também deverá fornecer o nome da classe de dados em CustomBandClass.

Para obter mais informações sobre esses valores, consulte OID_WWAN_DEVICE_CAPS.

CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN]

Uma cadeia de caracteres terminada em NULL que representa o nome da classe de banda personalizada. Esse membro só é válido quando o driver de miniporto define o bit WWAN_BAND_CLASS_CUSTOM nos membros WwanGsmBandClass ou WwanCdmaBandClass , conforme apropriado.

WwanSmsCaps

Um bitmap que representa o tipo de mensagens SMS e o fluxo direcional que o dispositivo dá suporte. A tabela a seguir mostra as configurações válidas de funcionalidades de SMS.

Valor	Significado
WWAN_SMS_CAPS_NONE	O dispositivo não dá suporte a mensagens SMS.
WWAN_SMS_CAPS_PDU_SEND	Para dispositivos baseados em GSM, esse valor significa que o dispositivo dá suporte ao envio de mensagens SMS no estilo PDU. Para dispositivos baseados em CDMA, esse valor significa que o dispositivo é capaz de enviar mensagens SMS em formato binário, conforme definido na seção "Mensagem Ponto a Ponto sms 3.4.2.1" na especificação 3GPP2 C.S0015-A "Short Message Service (SMS) for Wideband Spread Spectrum Systems".
WWAN_SMS_CAPS_PDU_RECEIVE	Para dispositivos baseados em GSM, esse valor significa que o dispositivo dá suporte ao recebimento de mensagens SMS no estilo PDU. Para dispositivos baseados em CDMA, esse valor significa que o dispositivo é capaz de ler as mensagens SMS no formato binário, conforme definido na seção "Mensagem ponto a ponto sms 3.4.2.1" na especificação 3GPP2 C.S0015-A "Sms (Serviço de Mensagem Curta) para Sistemas de Espectro de Distribuição de Banda Larga".
WWAN_SMS_CAPS_TEXT_SEND	O dispositivo dá suporte ao envio de mensagens SMS no estilo texto. Esse sinalizador se aplica a dispositivos baseados em CDMA.
WWAN_SMS_CAPS_TEXT_RECEIVE	O dispositivo dá suporte ao recebimento de mensagens SMS no estilo texto. Esse sinalizador se aplica a dispositivos baseados em CDMA.

Os drivers de miniporto devem definir esse membro para refletir o suporte apenas para o formato de PDU GSM para receber e enviar SMS quando o provedor doméstico atual for compatível com vários modos. Portanto, se o driver de miniporto receber um SMS no formato nativo da classe celular, por exemplo, CDMA TEXT ou CDMA PDU, o driver de miniporto será necessário para fazer a tradução para a PDU do GSM e indique-a para o Serviço MB. Da mesma forma, se o driver de miniporto receber uma solicitação de envio no formato PDU GSM, será necessário fazer a tradução para o formato de classe celular nativa.

WwanControlCaps

Um bitmap que representa os recursos de controle compatíveis com o dispositivo. A tabela a seguir mostra as configurações válidas do WwanControlCaps para dispositivos baseados em GSM e CDMA.

Valor	Significado
WWAN_CTRL_CAPS_REG_MANUAL	Indica se a rede do provedor permite a seleção manual de rede. Os drivers de miniport para dispositivos baseados em GSM devem especificar esse sinalizador. Os drivers de miniport para dispositivos baseados em CDMA não devem especificar esse sinalizador.
WWAN_CTRL_CAPS_HW_RADIO_SWITCH	Indica a presença de um comutador de energia de rádio de hardware. Isso corresponde ao valor WwanDeviceTypeEmbedded da enumeração WWAN_DEVICE_TYPE.
WWAN_CTRL_CAPS_CDMA_MOBILE_IP	Indica que o dispositivo baseado em CDMA está configurado para dar suporte ao IP móvel. Esse sinalizador se aplica somente a dispositivos baseados em CDMA. Os drivers de miniporto não devem definir esse sinalizador quando o provedor doméstico atual tem capacidade para vários modos.
WWAN_CTRL_CAPS_CDMA_SIMPLE_IP	Indica que o dispositivo baseado em CDMA está configurado para suporte a IP simples. Esse sinalizador se aplica somente a dispositivos baseados em CDMA. Os drivers de miniporto não devem definir esse sinalizador quando o provedor doméstico atual tem capacidade para vários modos.
WWAN_CTRL_CAPS_CDMA_MOBILE_IP combinado com WWAN_CTRL_CAPS_CDMA_SIMPLE_IP	Indica que o dispositivo baseado em CDMA está configurado para dar suporte ao IP móvel, com IP simples como uma opção de fallback.
WWAN_CTRL_CAPS_PROTECT_UNIQUEID	Indica que o Windows não deve exibir a IMSI (Identidade Internacional do Assinante Móvel).
WWAN_CTRL_CAPS_USSD	Indica que o dispositivo MB baseado em GSM está configurado para dar suporte ao protocolo USSD. Esse sinalizador se aplica somente a dispositivos baseados em GSM. Os drivers de miniport que dão suporte ao envio e recebimento de mensagens USSD definem esse sinalizador. Os drivers de miniporto podem definir esse sinalizador quando os provedores domésticos compatíveis com vários modos atuais do lado GSM da rede dão suporte a USSD mesmo que o lado CDMA da rede não dê suporte a USSD.
WWAN_CTRL_CAPS_MODEL_MULTI_CARRIER	Indica que o dispositivo MB dá suporte ao registro e à conexão a vários operadores de rede.
WWAN_CTRL_CAPS_MULTI_MODE	Esse sinalizador indica que o provedor doméstico atual dá suporte a várias classes celulares/RATs (Radio Access Technologies).

Os drivers de miniporte de dispositivos baseados em CDMA devem especificar WWAN_CTRL_CAPS_CDMA_MOBILE_IP ou WWAN_CTRL_CAPS_CDMA_SIMPLE_IP ou ambos os sinalizadores para informar o Serviço MB sobre o tipo de IP compatível com o dispositivo.

DeviceId[WWAN_DEVICEID_LEN]

Uma cadeia de caracteres terminada em NULL que representa a ID do dispositivo.

Para dispositivos baseados em GSM, a cadeia de caracteres deve estar em conformidade com o formato IMEI (Identidade de Equipamento Móvel Internacional) (até 15 dígitos).

Para dispositivos baseados em CDMA, a cadeia de caracteres deve estar em conformidade com os formatos ESN (Número de Série Eletrônico, 11 dígitos) e Identificador de Equipamento Móvel (MEID, 17 dígitos).

Para drivers de miniporta compatíveis com vários modos, por exemplo, aqueles que definem o sinalizador WWAN_CTRL_CAPS_MULTI_MODE no WwanControlCaps, somente o DeviceId baseado em GSM deve ser relatado.

Esse valor deve ser armazenado na memória do dispositivo e deve estar disponível mesmo quando o dispositivo MB/SIM requer um PIN para desbloquear.

Manufacturer[WWAN_MANUFACTURER_LEN]

Uma cadeia de caracteres terminada em NULL que representa o fabricante do dispositivo. Esse membro é opcional.

Model[WWAN_MODEL_LEN]

Uma cadeia de caracteres terminada em NULL que representa o modelo do dispositivo. Esse membro é opcional.

FirmwareInfo[WWAN_FIRMWARE_LEN]

Uma cadeia de caracteres terminada em NULL que representa as informações específicas do firmware sobre o dispositivo. Esse membro é opcional.

MaxActivatedContexts

O número máximo de contextos ativados compatíveis com o dispositivo. Os drivers de miniport devem impor esse limite falhando em tentativas de ativação que excedam MaxActivatedContexts.

WwanAuthAlgoCaps

Um bitmap que representa os tipos de métodos de autenticação aos quais o dispositivo MB dá suporte.

Valor	Significado
WWAN_AUTH_ALGO_CAPS_NONE	O dispositivo MB não dá suporte a nenhum método de autenticação.
WWAN_AUTH_ALGO_CAPS_SIM	O dispositivo MB dá suporte ao método de autenticação SIM.
WWAN_AUTH_ALGO_CAPS_AKA	O dispositivo MB dá suporte ao método de autenticação AKA.
WWAN_AUTH_ALGO_CAPS_AKAP	O dispositivo MB dá suporte ao método de autenticação AKA (AKA Prime).

ExecutorIndex

O membro WwanDeviceType para WWAN_DEVICE_CAPS_EX_REV1 não se refere mais ao dispositivo modem, mas sim a um executor individual. Cada dispositivo é uma entidade de executor RF da qual o sistema operacional está ciente.

WwanOptionalServiceCaps

Uma estrutura ULONG que representa as extensões de serviço da Microsoft que o modem subjacente dá suporte. É uma estrutura de bitmap de 64 bits que cujos bits indefinidos são reservados e devem ser definidos como "0". À medida que novas extensões de serviço forem introduzidas, os bits reservados serão usados para representar as novas extensões de serviço.

Valor

Mask

Significado

WWAN_OPTIONAL_SERVICE_CAPS_NONE

O dispositivo e o driver não dão suporte a extensões de serviço opcionais.

WWAN_OPTIONAL_SERVICE_CAPS_LTE_ATTACH

O dispositivo e o driver dão suporte à configuração de anexação LTE e aos seguintes CIDs do MBIM:

MBIM_CID_MS_LTE_ATTACH_CONFIG
MBIM_CID_MS_LTE_ATTACH_STATUS

WWAN_OPTIONAL_SERVICE_CAPS_CONTEXT_MGMT

O dispositivo e o driver dão suporte ao sistema operacional que gerencia contextos provisionados de modem e ao seguinte CID do MBIM:

MBIM_CID_PROVISIONED_CONTEXT_V2

WWAN_OPTIONAL_SERVICE_CAPS_MULTI_SIM

O dispositivo e o driver dão suporte a vários SIM/vários executores e aos seguintes OIDs:

WWAN_OPTIONAL_SERVICE_CAPS_EX_SAR

O dispositivo e o driver dão suporte à configuração de SAR do sistema operacional e dos seguintes CIDs do MBIM:

MBIM_CID_MS_SAR_CONFIG
MBIM_CID_MS_TRANSMISSION_STATUS

WWAN_OPTIONAL_SERVICE_CAPS_NETWORK_BLACKLIST

16h

O dispositivo e o driver dão suporte à configuração da lista de remetentes bloqueados de rede do sistema operacional e do seguinte CID do MBIM:

MBIM_CID_MS_NETWORK_BLACKLIST

WWAN_OPTIONAL_SERVICE_CAPS_5G_NSA

O dispositivo e o driver dão suporte a todas as novas extensões relacionadas ao 5G no Windows 10, versão 1903. A tabela a seguir mostra as mensagens NDIS e suas revisões que o driver de miniporto deve dar suporte se esse bit estiver definido.

OID	Mensagem	Revisão
WWAN_DEVICE_CAPS_EX	NDIS_WWAN_DEVICE_CAPS_EX	1
WWAN_REGISTER_STATE	NDIS_WWAN_REGISTRATION_STATE	3
WWAN_PACKET_SERVICE	NDIS_WWAN_PACKET_SERVICE_STATE	2
WWAN_SIGNAL_STATE	NDIS_WWAN_SIGNAL_STATE	2

CellularClassListHeader

Um objeto WWAN_LIST_HEADER formatado que representa uma lista de classes celulares compatíveis com um dispositivo compatível com vários modos. O membro ElementType no WWAN_LIST_HEADER sempre deve ser definido como WwanStructCellularClass. O membro ElementCount no WWAN_LIST_HEADER é definido como o número de classes da rede celular que seguem a estrutura WWAN_LIST_HEADER. Os dispositivos MB que não são compatíveis com vários modos devem definir ElementCount como 0.

Comentários

Os drivers de miniporte devem especificar WWAN_DATA_CLASS_CUSTOM se o serviço de dados com suporte pelo dispositivo não pertencer a nenhum dos outros valores definidos na tabela para o membro WwanDataClass . Se um driver de miniporto definir o sinalizador WWAN_DATA_CLASS_CUSTOM, o driver de miniporte também deverá fornecer o nome da classe de dados no membro CustomDataClass .

Para dispositivos baseados em GSM, apenas as classes de dados baseadas em GSM devem ser especificadas. Por exemplo, GPRS, EDGE, UMTS, HSDPA, LTE e TD-SCDMA. Se o driver de miniporta der suporte a TD-SCDMA, ele deverá especificar WWAN_DATA_CLASS_CUSTOM no membro WwanDataClass e a cadeia de caracteres "TD-SCDMA" no membro CustomDataClass .

Para dispositivos baseados em CDMA, somente os serviços de dados relacionados ao CDMA devem ser especificados. Por exemplo, 1xRTT, 1xEV-DO, 1xEV-DO RevA e UMB. 1xEV-DO RevB é definido para uso futuro. 1xEV-DV e 3xRTT também são definidos para integridade.