OID_WWAN_RADIO_STATE

OID_WWAN_RADIO_STATE définit ou retourne des informations sur l’état d’alimentation radio d’un appareil Mo.

Les pilotes Miniport doivent traiter les requêtes définies et de requête de manière asynchrone, en retournant d’abord NDIS_STATUS_INDICATION_REQUIRED à la requête d’origine, puis en envoyant une notification NDIS_STATUS_WWAN_RADIO_STATE status contenant une structure de NDIS_WWAN_RADIO_STATE qui indique l’état d’alimentation radio actuel du périphérique Mo, quelle que soit la fin des demandes de définition ou de requête.

Les appelants qui demandent à définir l’état d’alimentation radio de l’appareil Mo fournissent une structure NDIS_WWAN_SET_RADIO_STATE au pilote miniport avec les informations appropriées.

Notes

Pour plus d’informations sur l’utilisation de cet OID, consultez Mb Radio State.

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.

Les pilotes Miniport doivent conserver les états d’alimentation radio logicielle pendant le redémarrage du système ou la suppression et la réintégration des appareils. Les pilotes Miniport doivent stocker les informations radio logicielles de l’appareil et les utiliser pour définir l’état d’alimentation radio du logiciel du périphérique immédiatement à chaque redémarrage ou réinsérer l’appareil. L’état effectif de l’alimentation radio de l’appareil est déterminé en fonction de la combinaison de l’état de l’alimentation radio logicielle et matérielle, conformément au tableau dans WWAN_RADIO_STATE.

Si la valeur est WwanRadioOn, les pilotes miniport doivent activer l’alimentation radio et définir le membre RadioState.SwRadioState de la structure WWAN_RADIO_STATE sur WwanRadioOn. Si le membre RadioState.HwRadioState était WwanRadioOff, les pilotes miniport doivent mettre en cache ces informations d’état d’alimentation et veiller à activer physiquement l’état d’alimentation radio lorsque RadioState.HwRadioState passe à WwanRadioOn.

Si la valeur est WwanRadioOff, les pilotes miniport doivent désactiver l’état d’alimentation radio et définir le membre RadioState.SwRadioState sur WwanRadioOff.

Reportez-vous au tableau suivant pour connaître la programmation d’état radio attendue par les pilotes de miniport.

Combinaisons valides pour le mode pin et l’état du code confidentiel

Valeur HwRadioState	Valeur SwRadioState	État de l’alimentation radio globale
WwanRadioOff	WwanRadioOff	WwanRadioOff
WwanRadioOff	WwanRadioOn	WwanRadioOff
WwanRadioOn	WwanRadioOff	WwanRadioOff
WwanRadioOn	WwanRadioOn	WwanRadioOn

Pour les appareils qui ne fournissent pas de commutateur d’alimentation radio matériel, le membre RadioState.HwRadioState de la structure NDIS_WWAN_RADIO_STATE doit toujours être défini sur WwanRadioOn.

À compter de Windows 10, version 1703, OID_WWAN_RADIO_STATE a des spécifications supplémentaires pour la façon dont un modem pris en charge par plusieurs exécuteurs doit gérer la configuration de l’état radio à partir du système d’exploitation.

Avec un modem pris en charge par plusieurs exécuteurs, la configuration de l’état d’alimentation radio par exécuteur présente des avantages en matière d’alimentation. Quand la radio d’un exécuteur est désactivée, le système d’exploitation s’attend à ce que le modem se désinscrire du réseau et ne tente pas d’analyse ou de mise à jour d’emplacement à partir de celui-ci. Le modem doit prendre en charge un état radio pour chaque exécuteur qu’il publie auprès du système d’exploitation afin qu’il puisse déterminer l’état d’alimentation matérielle dans lequel il doit être.

Par exemple, si le modem a deux exécuteurs et que l’un des exécuteurs radio est désactivé alors que l’autre est allumé, le modem peut maintenir le front-end RF sous tension pour maintenir l’inscription sur l’exécuteur dont la radio est activée, mais n’a pas besoin d’effectuer des analyses/ping/mises à jour de localisation ou d’autres services cellulaires pour l’exécuteur qui est désactivé. Si les deux radios sont désactivées, le modem peut désactiver son front-end RF et réduire l’alimentation de l’ensemble du matériel. Les spécificités de l’implémentation sont laissées à chaque IHV.

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_RADIO_STATE

NDIS_WWAN_SET_RADIO_STATE

NDIS_STATUS_WWAN_RADIO_STATE

État de la radio mb

WWAN_RADIO_STATE