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 capacité de l’appareil/de l’exécuteur du matériel, y compris la fonctionnalité sur des fonctionnalités facultatives étendues telles que la configuration APN d’attachement LTE.
Les pilotes Miniport doivent traiter les requêtes de manière asynchrone, en retournant d’abord NDIS_STATUS_INDICATION_REQUIRED à la demande d’origine avant d’envoyer ultérieurement une notification NDIS_STATUS_WWAN_DEVICE_CAPS_EX status contenant une structure de 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 demande de requête.
Les requêtes définies ne sont pas applicables.
Notes
Il est essentiel pour le pilote de signaler 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. Cette OID est la même structure que les OID_WWAN_DEVICE_CAPS existantes, 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.
Comme avec OID_WWAN_DEVICE_CAPS, les paramètres de cet OID ne sont pas censés changer en raison des 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 donc avoir plusieurs interfaces qui prennent en charge OID_WWAN_DEVICE_CAPS_EX.
Pour les mises à jour futures 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 version la plus récente de la structure OID qu’il prend en charge. Si la version demandée du système d’exploitation est antérieure à la dernière version 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 IHVs 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 dans 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 toutes 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_CAPS existant ; leur comportement avec des modems compatibles avec plusieurs exécuteurs n’est pas un scénario pris en charge. Les IHVs 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 des structures de données qu’il contient si le pilote miniport prend en charge la 5G.
Lorsque l’hôte interroge les fonctionnalités à l’aide de cet OID, le pilote miniport doit case activée 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 des capacités 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 à la 5G.
Pour plus d’informations sur la prise en charge des classes de données 5G, consultez Prise en charge de la classe de données MO 5G.
Spécifications
Version |
Windows 10 version 1703 |
En-tête |
Ntddndis.h (inclure Ndis.h) |