WWAN_DEVICE_CAPS_EX_REV1 structure (wwan.h)
Important
Communication sans stéréotype
Microsoft prend en charge un environnement diversifié et inclusif. Cet article contient des références à la terminologie que le guide de style Microsoft pour la communication sans préjugés reconnaît comme une exclusion. Le mot ou l’expression est utilisé dans cet article à des fins de cohérence, car il apparaît actuellement dans le logiciel. Lorsque le logiciel est mis à jour pour supprimer la langue, cet article est mis à jour pour être aligné.
La structure WWAN_DEVICE_CAPS_EX_REV1 représente les fonctionnalités d’un appareil haut débit mobile. WWAN_DEVICE_CAPS_EX_REV1 met à jour la structure WWAN_DEVICE_CAPS_EX existante en supprimant les champs suivants :
- WwanSimClassBitMasks
- WwanWCDMABandClass
- WwanLTEBandClass
- WwanNRBandClass
- WwanMiscCaps
Syntaxe
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;
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 miniport ne doivent pas définir cet indicateur lorsque le fournisseur d’accueil actuel est compatible multimode. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP combinés avec 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 MB 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 actuel des fournisseurs d’accueil compatibles multimodes du réseau 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). |
ExecutorIndex
Le membre WwanDeviceType pour WWAN_DEVICE_CAPS_EX_REV1 ne fait plus référence au périphérique modem, mais plutôt à un exécuteur individuel. Chaque appareil est une entité d’exécuteur RF dont le système d’exploitation est conscient.
WwanOptionalServiceCaps
Structure ULONG qui représente les extensions de service Microsoft que le modem sous-jacent prend en charge. Il s’agit d’une structure bitmap 64 bits dont les bits non définis sont réservés et doivent être définis sur « 0 ». À mesure que de nouvelles extensions de service sont introduites, les bits réservés sont utilisés pour représenter les nouvelles extensions de service.
| Valeur | Mask | Signification | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| WWAN_OPTIONAL_SERVICE_CAPS_NONE | 0h | Le périphérique et le pilote ne prennent pas en charge les extensions de service facultatives. | |||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_LTE_ATTACH | 1h | Le périphérique et le pilote prennent en charge la configuration d’attachement LTE et les CID MBIM suivants :
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_CONTEXT_MGMT | 2 h | Le périphérique et le pilote prennent en charge le système d’exploitation gérant les contextes provisionnés par modem et le CID MBIM suivant :
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_MULTI_SIM | 4h | Le périphérique et le pilote prennent en charge les multi-SIM/multi-exécuteurs et les OID suivants : | |||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_EX_SAR | 8h | Le périphérique et le pilote prennent en charge la configuration SAR à partir du système d’exploitation et des CID MBIM suivants :
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_NETWORK_BLACKLIST | 16h | Le périphérique et le pilote prennent en charge la configuration des expéditeurs réseau bloqués à partir du système d’exploitation et du CID MBIM suivant :
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_5G_NSA | Le périphérique et le pilote prennent en charge toutes les nouvelles extensions liées à la 5G dans Windows 10, version 1903. Le tableau suivant présente les messages NDIS et leurs révisions que le pilote miniport doit prendre en charge si ce bit est défini.
|
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.
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 future. 1xEV-DV et 3xRTT sont également définis pour l’exhaustivité.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 2004 |
| En-tête | wwan.h |