OID_WWAN_SIGNAL_STATE
OID_WWAN_SIGNAL_STATE renvoie ou définit l’état actuel du signal.
Les pilotes miniport doivent traiter de manière asynchrone les demandes définies et de requête, en retournant initialement NDIS_STATUS_INDICATION_REQUIRED à la demande d’origine, puis en envoyant une notification d’état NDIS_STATUS_WWAN_SIGNAL_STATE contenant une structure de NDIS_WWAN_SIGNAL_STATE pour fournir des informations sur l’indication d’état du signal actuel affichée à l’utilisateur final, indépendamment de la fin de l’ensemble ou des demandes de requête.
Les appelants demandant de définir l’indication d’état du signal actuel à l’utilisateur final fournissent une structure NDIS_WWAN_SET_SIGNAL_INDICATION au pilote miniport avec les informations appropriées.
Remarques
Pour plus d’informations sur l’utilisation de cet OID, consultez opérations WWAN Signal Strength.
Les pilotes miniport ne doivent pas accéder au réseau du fournisseur ou au module d’identité de l’abonné (carte SIM), lors du traitement des opérations de requête ou de définition.
En règle générale, l’état du signal doit être indiqué plutôt que interrogé. Toutefois, cet OID est mis à disposition si l’état actuel du signal doit être déterminé par le service Mo.
Pour répondre aux requêtes, les pilotes miniport doivent envoyer une notification de NDIS_STATUS_WWAN_SIGNAL_STATE.
Sur une demande définie du service Mo, les pilotes miniport doivent :
Retournez les valeurs actuelles pour Rssi et ErrorRate dans la structure NDIS_WWAN_SIGNAL_STATE en plus de signaler les valeurs absolues pour RssiInterval et RssiThreshold qui a été défini dans le pilote miniport.
Mettant en cache en interne les valeurs RssiInterval et/ou RssiThreshold même si l’appareil n’est actuellement inscrit auprès d’aucun opérateur et que toute restriction imposée par l’appareil dans les paramètres ne peut être possible qu’après l’inscription. Le pilote miniport doit essayer d’appliquer ces paramètres dans la prochaine situation immédiate disponible.
Terminez la requête correctement, si l’état du commutateur radio matériel et/ou logiciel est actuellement désactivé. Le pilote Miniport met en cache les données de requête et commence à signaler la puissance du signal une fois le commutateur activé.
Peut échouer cette requête avec le jeu de code d’erreur uStatus approprié.
Les pilotes miniport peuvent effectuer les opérations suivantes lors du traitement des requêtes à partir du service Mo :
Retournez les valeurs actuelles pour Rssi et ErrorRate dans la structure NDIS_WWAN_SIGNAL_STATE en plus de signaler les valeurs absolues pour RssiInterval et RssiThreshold qui a été défini dans le pilote miniport.
Échouez cette requête avec le jeu de code d’erreur uStatus approprié.
Valeurs de retour :
NDIS_STATUS_NOT_SUPPORTED
Les pilotes miniport peuvent renvoyer ceci pour des appareils spécifiques qui connaissent les fonctionnalités des appareils qui ne prennent pas en charge la force du signal peuvent échouer la requête avec ce code d’erreur.
d’implémentation recommandée
Les appareils doivent prendre en charge les indications de force du signal.
Les pilotes doivent signaler des indications de force de signal d’au moins 50% du paramètre RssiInterval sur une période de cinq minutes.
Les appareils doivent éviter de signaler la puissance du signal dans les états suivants :
L’appareil n’est pas inscrit ou désinscrit et s’applique uniquement aux appareils GSM.
L’état effectif de la radio est OFF.
Dans les états ci-dessus, une requête à la force du signal doit être retournée avec les données suivantes par le pilote miniport :
Rssi = WWAN_RSSI_UNKNOWN
ErrorRate = WWAN_ERROR_RATE_UNKNOWN ;
RssiInterval = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT ou dernière valeur définie>
RssiThreshold = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT ou la dernière valeur définie>
Windows 10, version 1903
À compter de Windows 10, version 1903, OID_WWAN_SIGNAL_STATE a été mis à niveau vers la révision 3. Cette révision permet à l’hôte d’interroger de nouvelles valeurs de puissance de réception du signal de référence (RSRP) et de signal à bruit (SNR) du pilote miniport. Un pilote miniport doit utiliser la révision 3 de cet OID et ses structures de données si le pilote prend en charge 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 |
Disponible dans Windows 7 et versions ultérieures de Windows. |
En-tête |
Ntddndis.h (include Ndis.h) |