structure WWAN_DEVICE_CAPS_EX (wwan.h)

La structure WWAN_DEVICE_CAPS_EX représente les fonctionnalités de l’appareil haut débit mobile. WWAN_DEVICE_CAPS_EX étend la structure WWAN_DEVICE_CAPS existante en ajoutant un membre Executor Index , pour le suivi d’exécuteurs spécifiques, et un membre WwanOptionalServiceCaps , pour les extensions de service Microsoft.

Syntaxe

typedef struct _WWAN_DEVICE_CAPS_EX {
  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;
  ULONG               WwanSimClassBitMasks;
  ULONG               WwanWCDMABandClass;
  USHORT              WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND];
  USHORT              WwanNRBandClass[WWAN_MAX_NUM_NR_BAND];
  ULONGLONG           WwanDataSubClass;
  ULONGLONG           WwanMiscCaps;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX, *PWWAN_DEVICE_CAPS_EX;

Membres

WwanDeviceType

Type de l’appareil. Les pilotes miniport doivent définir le type d’appareil 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 WwanCellularClassUnknown. Les valeurs de ce membre contrôle fonctionnalités spécifiques à la technologie cellulaire, telles que les modes d’inscription du fournisseur de réseau.

Les pilotes miniports qui prennent en charge le mode multimode doivent le définir 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 à basculement de circuit en mode natif et ne l’empêche pas. C’est au pilote miniport de déterminer comment prendre en charge la voix du circuit. Ce membre WwanVoiceClass permet au service MB de prendre en charge cette fonctionnalité à l’avenir.

WwanSimClass

Classe du module d’identité de l’abonné (carte SIM) spécifiée par l’énumération WWAN_SIM_CLASS. 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.

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 la prise en charge des appareils GSM de bandes de fréquences. Le tableau suivant montre les valeurs possibles pour ce membre.

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.

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.

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.

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.

ExecutorIndex

Le membre WwanDeviceType pour WWAN_DEVICE_CAPS_EX 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.

WwanSimClassBitMasks

Bitmap qui représente des masques de classe SIM. Il doit au moins contenir le masque correspondant au champ WwanSimClass .

WwanWCDMABandClass

Numéro de bande défini dans 3GPP TS25.101 pour FDD. Le LSB indique le numéro de bande 1 (2100 MHz).

WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND]

WwanNRBandClass[WWAN_MAX_NUM_NR_BAND]

WwanDataSubClass

Bitmap qui représente la ou les sous-classes de données que l’appareil prend en charge.

WwanMiscCaps

Bitmap qui représente diverses fonctionnalités prises en charge par l’appareil. |Valeur| |--- | |WWAN_DEVICE_MISC_CAPS_NONE 0x00000000| |WWAN_DEVICE_MISC_CAPS_ETHERNET_PDU_SESSION 0x00000001| |WWAN_DEVICE_MISC_CAPS_UNSTRUCTURED_PDU_SESSION 0x00000002| |WWAN_DEVICE_MISC_CAPS_ESIM 0x00000004| |WWAN_DEVICE_MISC_CAPS_REFLECTIVE_QOS 0x00000008|

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 ultérieure. 1xEV-DV et 3xRTT sont également définis pour l’exhaustivité.

Configuration requise

Voir aussi

NDIS_WWAN_DEVICE_CAPS_EX

OID_WWAN_DEVICE_CAPS_EX

WWAN_DEVICE_CAPS