estrutura WWAN_DEVICE_CAPS (wwan.h)
A estrutura WWAN_DEVICE_CAPS representa os recursos do dispositivo MB.
Sintaxe
typedef struct _WWAN_DEVICE_CAPS {
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;
WWAN_LIST_HEADER CellularClassListHeader;
} WWAN_DEVICE_CAPS, *PWWAN_DEVICE_CAPS;
Membros
WwanDeviceType
O tipo do dispositivo. Os drivers de miniporto 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 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 comutada por circuito nativamente, nem o impede. Cabe ao driver de miniporta 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 miniporto 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 de rádio de pacotes) geral. Esse valor se aplica somente a dispositivos baseados em GSM. |
| WWAN_DATA_CLASS_EDGE | Há suporte para o serviço de dados de EDGE (Dados Avançados para Evolução Global). Esse valor se aplica somente a dispositivos baseados em GSM. |
| WWAN_DATA_CLASS_UMTS | Há suporte para o serviço de dados UMTS (Universal Mobile Telecommunications System). 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 de 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 o serviço de dados Otimizado (originalmente Somente Dados, 1xEDVO, também conhecido como CDMA2000 serviço de dados EV-DO 1x 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 | Há suporte para o serviço de dados CDMA Evolution-Data/Voice (também conhecido como CDMA 2000 1x EV-DV ou EVDV 1x). 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 é válido somente quando o driver de miniporto define o WWAN_DATA_CLASS_CUSTOM bit 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. Therefure, 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 ored 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 com 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). |
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 Internacional de Equipamento Móvel) (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 em 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 miniporta devem impor esse limite falhando em todas as 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 (também conhecido como Prime). |
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 celulares 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 miniporto devem especificar WWAN_DATA_CLASS_CUSTOM se o serviço de dados compatível com o dispositivo não pertencer a nenhum dos outros valores definidos na tabela para o membro WwanDataClass . Se um driver de miniporta definir o sinalizador WWAN_DATA_CLASS_CUSTOM, o driver de miniporto também deverá fornecer o nome da classe de dados no membro CustomDataClass .
Para dispositivos baseados em GSM, somente 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.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível em Windows 8 e versões posteriores do Windows. |
| Cabeçalho | wwan.h (inclua Wwan.h) |