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.

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.

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.

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

WWAN_CELLULAR_CLASS

WWAN_DEVICE_TYPE

WWAN_SIM_CLASS

WWAN_VOICE_CLASS