Partager via


OID_WWAN_DEVICE_CAPS_EX

OID_WWAN_DEVICE_CAPS_EX est similaire à OID_WWAN_DEVICE_CAPS mais est un OID par exécuteur, contrairement à OID_WWAN_DEVICE_CAPS qui est un OID par appareil. Cet OID sert à indiquer la fonctionnalité appareil/exécuteur du matériel, y compris la fonctionnalité sur les fonctionnalités facultatives étendues telles que la configuration APN d’attachement LTE.

Les pilotes miniport doivent traiter les requêtes de manière asynchrone, retournant initialement NDIS_STATUS_INDICATION_REQUIRED à la requête d’origine avant d’envoyer ultérieurement une notification d’état de NDIS_STATUS_WWAN_DEVICE_CAPS_EX contenant une structure NDIS_WWAN_DEVICE_CAPS_EX, qui à son tour contient une structure WWAN_DEVICE_CAPS_EX, pour fournir des informations sur la capacité de l’appareil.

Le diagramme suivant illustre une requête de requête.

Diagramme montrant le processus de requête de fonctionnalité d’exécuteur.

Les demandes définies ne sont pas applicables.

Remarques

Il est essentiel que le pilote signale la fonctionnalité d’extension de service dans son ensemble, y compris du pilote à l’appareil réel. Si un pilote prend en charge un service mais qu’il n’est pas pris en charge par le matériel sous-jacent, les fonctionnalités du service doivent être marquées comme FALSE.

OID_WWAN_DEVICE_CAPS_EX est également utilisé pour récupérer la fonctionnalité de chaque exécuteur. Cet OID est le même dans la structure que les OID_WWAN_DEVICE_CAPS existants, mais avec l’ajout de l’ID d’exécuteur . Un pilote miniport doit signaler la version OID la plus élevée qu’il prend en charge.

Tout comme avec OID_WWAN_DEVICE_CAPS, les paramètres de cet OID ne sont pas censés changer en raison de cartes SIM, mais représentent plutôt la capacité RF du modem de l’exécuteur sélectionné. Un modem matériel physique peut avoir plusieurs exécuteurs et peut donc avoir plusieurs interfaces qui prennent en charge OID_WWAN_DEVICE_CAPS_EX.

Pour les futures mises à jour possibles, si la version demandée du système d’exploitation est plus récente que la version prise en charge par l’appareil, l’appareil doit retourner la dernière version de la structure OID prise en charge. Si la version demandée du système d’exploitation est antérieure à la dernière prise en charge par l’appareil, l’appareil doit retourner la version correspondant à la spécification du système d’exploitation. Il est obligatoire pour les IHD de s’assurer que toutes les révisions de OID_WWAN_DEVICE_CAPS_EX sont prises en charge pour la compatibilité descendante et la prise en charge héritée.

Contrairement aux autres OID nouveaux de Windows 10 version 1703 qui ne sont nécessaires que si le modem prend en charge les multi-SIM/multi-exécuteurs, cet OID doit être implémenté pour les modems qui souhaitent prendre en charge les extensions de service définies par Microsoft à partir de Windows 10 Version 1703.

Les versions de Windows antérieures à Windows 10 version 1703 peuvent toujours utiliser le OID_WWAN_DEVICE_CAPSexistant ; leur comportement avec des modems compatibles multi-exécuteur n’est pas un scénario pris en charge. Les IHD doivent définir ce comportement.

Windows 10, version 1903

À compter de Windows 10, version 1903, OID_WWAN_DEVICE_CAPS_EX a été mis à niveau vers la révision 2. Un pilote miniport doit utiliser la révision 2 de cet OID et les structures de données qu’il contient si le pilote miniport prend en charge 5G.

Lorsque les fonctionnalités de l’hôte interrogent à l’aide de cet OID, le pilote miniport doit vérifier si le matériel sous-jacent prend en charge les fonctionnalités cellulaires 5G. Si c’est le cas, le pilote miniport définit le masque de bits dans le champ WwanDataClass de la structure WWAN_DEVICE_CAPS_EX en fonction de la capabilties matérielles.

En outre, dans le champ WwanOptionalServiceCaps de la structure WWAN_DEVICE_CAPS_EX, un nouveau bit de service facultatif est défini qui couvre la prise en charge de toutes les nouvelles extensions liées à 5G.

Pour plus d’informations sur la prise en charge de la classe de données 5G, consultez prise en charge de la classe de données 5G mo.

Exigences

Version

Windows 10, version 1703

En-tête

Ntddndis.h (include Ndis.h)

Voir aussi

OID_WWAN_DEVICE_CAPS

NDIS_STATUS_WWAN_DEVICE_CAPS_EX

NDIS_WWAN_DEVICE_CAPS_EX

WWAN_DEVICE_CAPS_EX