Partager via


WWAN_DEVICE_CAPS structure (wwan.h)

La structure WWAN_DEVICE_CAPS représente les fonctionnalités de l’appareil Mo.

Syntaxe

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;

Membres

WwanDeviceType

Type de l’appareil. Les pilotes Miniport doivent définir le type de périphérique sur une valeur autre que WwanDeviceTypeUnknown.

WwanCellularClass

Classe cellulaire de l’appareil. Les pilotes miniport doivent définir la classe cellulaire sur une valeur autre que Wwan CellularClassUnknown. Les valeurs de ce membre contrôlent les fonctionnalités spécifiques à la technologie cellulaire, telles que les modes d’inscription du fournisseur de réseau.

Les pilotes miniport qui prennent en charge le mode multimode doivent définir ce paramètre sur WwanCellularClassGsm.

WwanVoiceClass

Classe vocale de l’appareil. Ce membre informe le service MB de la présence du service vocal de circuit et de la façon dont ce service interagit avec le service de données. N’oubliez pas que le service Mb ne prend pas en charge la voix à circuit commuté en mode natif, ni ne l’exclut. Il appartient au pilote miniport de déterminer comment prendre en charge la voix du circuit. Ce membre WwanVoiceClass permet au service MO de prendre en charge cette fonctionnalité à l’avenir.

WwanSimClass

Classe du module d’identité de l’abonné (carte SIM). Les pilotes Miniport doivent définir la classe SIM sur une valeur autre que WwanSimClassUnknown.

WwanDataClass

Bitmap qui représente la ou les classes de données que l’appareil prend en charge. Le tableau suivant montre les valeurs possibles pour ce membre.

Valeur Signification
WWAN_DATA_CLASS_NONE L’appareil ne prend pas en charge le service de données.
WWAN_DATA_CLASS_GPRS Le service de données GPRS (General Packet Radio Service) est pris en charge. Cette valeur s’applique uniquement aux appareils GSM.
WWAN_DATA_CLASS_EDGE Le service de données Edge (Enhanced Data for Global Evolution) est pris en charge. Cette valeur s’applique uniquement aux appareils GSM.
WWAN_DATA_CLASS_UMTS Le service de données UMTS (Universal Mobile Telecommunications System) est pris en charge. Cette valeur s’applique uniquement aux appareils GSM.
WWAN_DATA_CLASS_HSDPA High-Speed service de données HSDPA (Downlink Packet Access) est pris en charge. Cette valeur s’applique uniquement aux appareils GSM.
WWAN_DATA_CLASS_HSUPA High-Speed service de données HSUPA (Uplink Packet Access) est pris en charge. Cette valeur s’applique uniquement aux appareils GSM.
WWAN_DATA_CLASS_LTE Le service de données LTE est pris en charge. Cette valeur s’applique uniquement aux appareils GSM.
WWAN_DATA_CLASS_5G Le service de données 5G est pris en charge.
WWAN_DATA_CLASS_TDSCDMA Le service de données CDMA synchrone time division est pris en charge.
WWAN_DATA_CLASS_1XRTT Le service de données CDMA 1x Radio Transmission Technology (1xRTT, également appelé cdma2000, CDMA2000 1x, etc.) est pris en charge. Cette valeur s’applique uniquement aux appareils CDMA.
WWAN_DATA_CLASS_1XEVDO CDMA Evolution-Data service de données optimisé (à l’origine data only, 1xEDVO, également appelé CDMA2000 1x EV-DO ou 1x EVDO) est pris en charge. Cette valeur s’applique uniquement aux appareils CDMA.
WWAN_DATA_CLASS_1XEVDO_REVA Le service de données RevA 1xEVDO est pris en charge. Cette valeur s’applique uniquement aux appareils CDMA.
WWAN_DATA_CLASS_1XEVDV Le service de données CDMA Evolution-Data/Voice (également appelé CDMA 2000 1x EV-DV ou 1x EVDV) est pris en charge. Cette valeur s’applique uniquement aux appareils CDMA.
WWAN_DATA_CLASS_3XRTT Le service de données CDMA 3x Radio Transmission Technology (3xRTT) est pris en charge. Cette valeur s’applique uniquement aux appareils CDMA.
WWAN_DATA_CLASS_1XEVDO_REVB Le service de données 1xEVDO RevB est pris en charge. Cette valeur s’applique uniquement aux appareils CDMA.
WWAN_DATA_CLASS_UMB Le service de données UMB est pris en charge. Cette valeur s’applique uniquement aux appareils CDMA.
WWAN_DATA_CLASS_CUSTOM L’appareil prend en charge un service de données non répertorié dans ce tableau.

CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]

Chaîne terminée par null qui représente le nom de la classe de données personnalisée. Ce membre est valide uniquement lorsque le pilote miniport définit le bit WWAN_DATA_CLASS_CUSTOM dans le membre WwanDataClass .

WwanGsmBandClass

Bitmap qui représente les bandes de fréquences prises en charge par les appareils GSM. Le tableau suivant montre les valeurs possibles pour ce membre.

Valeur Signification
WWAN_BAND_CLASS_UNKNOWN La bande de fréquence prise en charge par l’appareil n’est pas indiquée.
WWAN_BAND_CLASS_I L’appareil prend en charge le spectre UMTS2100.
WWAN_BAND_CLASS_II L’appareil prend en charge le spectre UMTS1900.
WWAN_BAND_CLASS_III L’appareil prend en charge le spectre UMTS1800.
WWAN_BAND_CLASS_IV L’appareil prend en charge le spectre AWS.
WWAN_BAND_CLASS_V L’appareil prend en charge le spectre UMTS850.
WWAN_BAND_CLASS_VI L’appareil prend en charge le spectre UMTS800.
WWAN_BAND_CLASS_VII L’appareil prend en charge le spectre UMTS2600.
WWAN_BAND_CLASS_VIII L’appareil prend en charge le spectre UMTS900.
WWAN_BAND_CLASS_IX L’appareil prend en charge le spectre UMTS1700.
WWAN_BAND_CLASS_X
WWAN_BAND_CLASS_CUSTOM L’appareil prend en charge un spectre autre que ceux répertoriés dans ce tableau.
 

Si le pilote miniport spécifie WWAN_BAND_CLASS_CUSTOM, il doit également fournir le nom de la classe de données dans CustomBandClass .

Pour plus d’informations sur ces valeurs, consultez OID_WWAN_DEVICE_CAPS.

WwanCdmaBandClass

Bitmap qui représente les bandes de fréquences prises en charge par les appareils CDMA. Le tableau suivant montre les valeurs possibles pour ce membre.

Valeur Signification
WWAN_BAND_CLASS_UNKNOWN La bande de fréquences prise en charge par l’appareil n’est pas indiquée.
WWAN_BAND_CLASS_0 L’appareil prend en charge la bande de 800 MHz.
WWAN_BAND_CLASS_I L’appareil prend en charge la bande 1900 MHz.
WWAN_BAND_CLASS_II L’appareil prend en charge la bande TACS.
WWAN_BAND_CLASS_III L’appareil prend en charge la bande JTACS.
WWAN_BAND_CLASS_IV L’appareil prend en charge la bande PCS coréenne.
WWAN_BAND_CLASS_V L’appareil prend en charge la bande de 450 MHz.
WWAN_BAND_CLASS_VI L’appareil prend en charge la bande de 2 GHz.
WWAN_BAND_CLASS_VII L’appareil prend en charge la bande de 700 MHz.
WWAN_BAND_CLASS_VIII L’appareil prend en charge la bande de 1800 MHz.
WWAN_BAND_CLASS_IX L’appareil prend en charge la bande de 900 MHz.
WWAN_BAND_CLASS_X L’appareil prend en charge la bande secondaire de 800 MHz.
WWAN_BAND_CLASS_XI L’appareil prend en charge la bande PAMR européenne de 400 MHz.
WWAN_BAND_CLASS_XII L’appareil prend en charge la bande PAMR 800 MHz.
WWAN_BAND_CLASS_XIII L’appareil prend en charge la bande d’extension 2,5 GHz IMT2000.
WWAN_BAND_CLASS_XIV L’appareil prend en charge la bande US PCS 1,9 GHz.
WWAN_BAND_CLASS_XV L’appareil prend en charge la bande AWS.
WWAN_BAND_CLASS_XVI L’appareil prend en charge la bande us 2,5 GHz.
WWAN_BAND_CLASS_XVII L’appareil prend en charge la bande us 2,5 GHz Forward Link Only.
WWAN_BAND_CLASS_CUSTOM L’appareil prend en charge une bande autre que les bandes répertoriées dans ce tableau.
 

Si le pilote miniport spécifie WWAN_BAND_CLASS_CUSTOM, il doit également fournir le nom de la classe de données dans CustomBandClass .

Pour plus d’informations sur ces valeurs, consultez OID_WWAN_DEVICE_CAPS.

CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN]

Chaîne terminée par NULL qui représente le nom de la classe de bande personnalisée. Ce membre est valide uniquement lorsque le pilote miniport définit le bit WWAN_BAND_CLASS_CUSTOM dans les membres WwanGsmBandClass ou WwanCdmaBandClass , le cas échéant.

WwanSmsCaps

Bitmap qui représente le type de messages SMS et le flux directionnel pris en charge par l’appareil. Le tableau suivant montre les paramètres de fonctionnalités SMS valides.

Valeur Signification
WWAN_SMS_CAPS_NONE L’appareil ne prend pas en charge les messages SMS.
WWAN_SMS_CAPS_PDU_SEND Pour les appareils GSM, cette valeur signifie que l’appareil prend en charge l’envoi de messages SMS de type PDU.

Pour les appareils CDMA, cette valeur signifie que l’appareil est capable d’envoyer des messages SMS au format binaire, comme défini dans la section « 3.4.2.1 SMS point à point » de la spécification 3GPP2 C.S0015-A « Short Message Service (SMS) for Wideband Spread Spectrum Systems ».

WWAN_SMS_CAPS_PDU_RECEIVE Pour les appareils GSM, cette valeur signifie que l’appareil prend en charge la réception de messages SMS de type PDU.

Pour les appareils CDMA, cette valeur signifie que l’appareil est capable de lire les messages SMS au format binaire, comme défini dans la section « 3.4.2.1 SMS point à point » de la spécification 3GPP2 C.S0015-A « Short Message Service (SMS) for Wideband Spread Spectrum Systems ».

WWAN_SMS_CAPS_TEXT_SEND L’appareil prend en charge l’envoi de sms de style texte. Cet indicateur s’applique aux appareils CDMA.
WWAN_SMS_CAPS_TEXT_RECEIVE L’appareil prend en charge la réception de messages SMS de style texte. Cet indicateur s’applique aux appareils CDMA.
 

Les pilotes miniport doivent définir ce membre pour refléter la prise en charge uniquement du format PDU GSM pour la réception et l’envoi de SMS lorsque le fournisseur d’accueil actuel est compatible multimode. Par conséquent, si le pilote miniport reçoit un SMS au format natif de la classe cellulaire, par exemple CDMA TEXT ou CDMA PDU, le pilote miniport doit effectuer la traduction en GSM PDU et l’indiquer au service MB. De même, si le pilote miniport reçoit une demande d’envoi au format GSM PDU, il est nécessaire d’effectuer la traduction vers son format de classe cellulaire natif.

WwanControlCaps

Bitmap qui représente les fonctionnalités de contrôle prises en charge par l’appareil. Le tableau suivant montre les paramètres WwanControlCaps valides pour les appareils GSM et CDMA.

Valeur Signification
WWAN_CTRL_CAPS_REG_MANUAL Indique si le réseau du fournisseur autorise la sélection manuelle du réseau. Les pilotes miniport pour les appareils GSM doivent spécifier cet indicateur. Les pilotes miniport pour les appareils CDMA ne doivent pas spécifier cet indicateur.
WWAN_CTRL_CAPS_HW_RADIO_SWITCH Indique la présence d’un commutateur d’alimentation radio matériel. Cela correspond à la valeur WwanDeviceTypeEmbedded de l’énumération WWAN_DEVICE_TYPE.
WWAN_CTRL_CAPS_CDMA_MOBILE_IP Indique que l’appareil CDMA est configuré pour prendre en charge l’adresse IP mobile. Cet indicateur s’applique uniquement aux appareils CDMA.

Les pilotes miniports ne doivent pas définir cet indicateur lorsque le fournisseur d’accueil actuel est compatible multimode.

WWAN_CTRL_CAPS_CDMA_SIMPLE_IP Indique que l’appareil basé sur CDMA est configuré pour une prise en charge IP simple. Cet indicateur s’applique uniquement aux appareils CDMA.

Les pilotes miniports ne doivent pas définir cet indicateur lorsque le fournisseur d’accueil actuel est compatible multimode.

WWAN_CTRL_CAPS_CDMA_MOBILE_IP ored with WWAN_CTRL_CAPS_CDMA_SIMPLE_IP Indique que l’appareil CDMA est configuré pour prendre en charge l’adresse IP mobile, avec une adresse IP simple comme option de secours.
WWAN_CTRL_CAPS_PROTECT_UNIQUEID Indique que Windows ne doit pas afficher l’identité IMSI (International Mobile Subscriber Identity).
WWAN_CTRL_CAPS_USSD Indique que l’appareil MO basé sur GSM est configuré pour prendre en charge le protocole USSD. Cet indicateur s’applique uniquement aux appareils GSM.

Les pilotes miniport qui prennent en charge l’envoi et la réception de messages USSD définissent cet indicateur.

Les pilotes miniport peuvent définir cet indicateur lorsque le côté GSM des fournisseurs d’accueil multimodes actuels prend en charge USSD même si le côté CDMA du réseau ne prend pas en charge USSD.

WWAN_CTRL_CAPS_MODEL_MULTI_CARRIER Indique que l’appareil Mo prend en charge l’inscription et la connexion à plusieurs opérateurs réseau.
WWAN_CTRL_CAPS_MULTI_MODE Cet indicateur indique que le fournisseur d’accueil actuel prend en charge plusieurs classes cellulaires/RAT (Radio Access Technologies).
 

Les pilotes miniport des appareils CDMA doivent spécifier WWAN_CTRL_CAPS_CDMA_MOBILE_IP, ou WWAN_CTRL_CAPS_CDMA_SIMPLE_IP, ou les deux indicateurs pour informer le service Mo du type d’adresse IP prise en charge par l’appareil.

DeviceId[WWAN_DEVICEID_LEN]

Chaîne terminée par NULL qui représente l’ID de l’appareil.

Pour les appareils GSM, la chaîne doit être conforme au format IMEI (International Mobile Equipment Identity) (jusqu’à 15 chiffres).

Pour les appareils CDMA, la chaîne doit être conforme aux formats Numéro de série électronique (ESN, 11 chiffres) et Identificateur d’équipement mobile (MEID, 17 chiffres).

Pour les pilotes miniport compatibles multimodes, par exemple ceux qui définissent l’indicateur WWAN_CTRL_CAPS_MULTI_MODE dans WwanControlCaps, seul l’Id deviceId basé sur GSM doit être signalé.

Cette valeur doit être stockée dans la mémoire de l’appareil et doit être disponible même lorsque l’appareil mo/SIM nécessite un code confidentiel pour le déverrouillage.

Manufacturer[WWAN_MANUFACTURER_LEN]

Chaîne terminée par NULL qui représente le fabricant de l’appareil. Ce membre est facultatif.

Model[WWAN_MODEL_LEN]

Chaîne terminée par NULL qui représente le modèle de l’appareil. Ce membre est facultatif.

FirmwareInfo[WWAN_FIRMWARE_LEN]

Chaîne terminée par null qui représente les informations spécifiques au microprogramme sur l’appareil. Ce membre est facultatif.

MaxActivatedContexts

Nombre maximal de contextes activés pris en charge par l’appareil. Les pilotes Miniport doivent appliquer cette limite en échouant toutes les tentatives d’activation qui dépassent MaxActivatedContexts.

WwanAuthAlgoCaps

Bitmap qui représente les types de méthodes d’authentification prises en charge par l’appareil Mo.

Valeur Signification
WWAN_AUTH_ALGO_CAPS_NONE L’appareil Mo ne prend pas en charge les méthodes d’authentification.
WWAN_AUTH_ALGO_CAPS_SIM L’appareil Mo prend en charge la méthode d’authentification SIM.
WWAN_AUTH_ALGO_CAPS_AKA L’appareil Mo prend en charge la méthode d’authentification AKA.
WWAN_AUTH_ALGO_CAPS_AKAP L’appareil Mo prend en charge la méthode d’authentification AKA (AKA Prime).
 
Note Ce membre est valide uniquement dans Windows 8 et versions ultérieures, lorsque NDIS_WWAN_DEVICE_CAPS_REVISION_2 est spécifié dans le sous-membre Header.Revision de la structure NDIS_WWAN_DEVICE_CAPS.
 

CellularClassListHeader

Objet WWAN_LIST_HEADER mis en forme qui représente une liste de classes cellulaires qu’un appareil compatible multimode prend en charge. Le membre ElementType dans WWAN_LIST_HEADER doit toujours être défini sur WwanStructCellulaireClass. Le membre ElementCount dans WWAN_LIST_HEADER est défini sur le nombre de classes cellulaires qui suivent la structure WWAN_LIST_HEADER. Les appareils mo qui ne sont pas compatibles avec plusieurs modes doivent définir ElementCount sur 0.

Note Ce membre est valide uniquement dans Windows 8 et versions ultérieures, lorsque NDIS_WWAN_DEVICE_CAPS_REVISION_2 est spécifié dans le sous-membre Header.Revision de la structure NDIS_WWAN_DEVICE_CAPS.
 

Remarques

Les pilotes Miniport doivent spécifier WWAN_DATA_CLASS_CUSTOM si le service de données pris en charge par l’appareil n’appartient à aucune des autres valeurs définies dans la table pour le membre WwanDataClass . Si un pilote miniport définit l’indicateur WWAN_DATA_CLASS_CUSTOM, il doit également fournir le nom de la classe de données dans le membre CustomDataClass .

Pour les appareils GSM, seules les classes de données gsm doivent être spécifiées. Par exemple, GPRS, EDGE, UMTS, HSDPA, LTE et TD-SCDMA. Si votre pilote miniport prend en charge TD-SCDMA, il doit spécifier WWAN_DATA_CLASS_CUSTOM dans le membre WwanDataClass et la chaîne « TD-SCDMA » dans le membre CustomDataClass .

Pour les appareils CDMA, seuls les services de données liés à CDMA doivent être spécifiés. Par exemple, 1xRTT, 1xEV-DO, 1xEV-DO RevA et UMB. 1xEV-DO RevB est défini pour une utilisation ultérieure. 1xEV-DV et 3xRTT sont également définis pour l’exhaustivité.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows 8 et versions ultérieures de Windows.
En-tête wwan.h (inclure Wwan.h)

Voir aussi

NDIS_WWAN_DEVICE_CAPS

WWAN_CELLULAR_CLASS

WWAN_DEVICE_TYPE

WWAN_SIM_CLASS

WWAN_VOICE_CLASS