OID_WWAN_SIGNAL_STATE

OID_WWAN_SIGNAL_STATE retourne ou définit l’état actuel du signal.

Les pilotes miniport doivent traiter les requêtes définies et de requête de manière asynchrone, en retournant initialement NDIS_STATUS_INDICATION_REQUIRED à la demande d’origine, puis en envoyant une notification NDIS_STATUS_WWAN_SIGNAL_STATE status contenant une structure de NDIS_WWAN_SIGNAL_STATE pour fournir des informations sur l’indication d’état du signal actuelle affichée à l’utilisateur final, indépendamment de la fin des demandes de jeu ou de requête.

Les appelants qui demandent à définir l’indication d’état du signal actuel pour l’utilisateur final fournissent une structure NDIS_WWAN_SET_SIGNAL_INDICATION au pilote miniport avec les informations appropriées.

Notes

Pour plus d’informations sur l’utilisation de cet OID, consultez Opérations de force du signal WWAN.

Les pilotes Miniport ne doivent pas accéder au réseau du fournisseur ou au module d’identité d’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 sondé. Toutefois, cet OID est mis à disposition au cas où l’état actuel du signal doit être déterminé par le service Mb.

Pour répondre aux demandes de requête, les pilotes miniport doivent envoyer une notification NDIS_STATUS_WWAN_SIGNAL_STATE.

Lors d’une requête définie du service Mo, les pilotes miniport doivent :

• Retourne 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 ont été définies dans le pilote miniport.

• Mettre 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 la définition des 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 disponible immédiatement.

• Effectuez la demande 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 l’intensité du signal une fois que le commutateur est activé.

• Cette requête peut échouer avec le code d’erreur uStatus approprié.

Les pilotes Miniport peuvent effectuer les opérations suivantes lors du traitement des requêtes à partir du service Mo :

• Retourne 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 ont été définies dans le pilote miniport.

• Échec de cette requête avec le code d’erreur uStatus approprié.

Valeurs de retour :

NDIS_STATUS_NOT_SUPPORTED

Les pilotes miniport peuvent retourner cela pour des appareils spécifiques qui sont conscients des fonctionnalités de l’appareil qui ne prennent pas en charge la puissance du signal peut échouer la demande avec ce code d’erreur.

Implémentation recommandée

1. Les appareils doivent prendre en charge les indications de force du signal.

2. Les conducteurs doivent signaler des indications de force du signal d’au moins 50 % du paramètre RssiInterval sur une période de cinq minutes.

3. Les appareils doivent éviter de signaler la puissance du signal dans les états suivants :

   1. Appareil non inscrit ou désinscrit et s’applique uniquement aux appareils GSM.

   2. L’état effectif de la radio est DÉSACTIVÉ.

   3. 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 valeur du dernier jeu>

      RssiThreshold = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT ou la valeur du dernier jeu>

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 les nouvelles valeurs RSRP (Signal to Noise) à partir du pilote miniport. Un pilote miniport doit utiliser la révision 3 de cet OID et de ses structures de données si le pilote prend en charge 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	Disponible dans Windows 7 et versions ultérieures de Windows.
En-tête	Ntddndis.h (inclure Ndis.h)

Voir aussi

NDIS_WWAN_SET_SIGNAL_INDICATION

Opérations de force du signal WWAN