OID_WWAN_RADIO_STATE
OID_WWAN_RADIO_STATE ustawia lub zwraca informacje o stanie zasilania radiowego urządzenia MB.
Sterowniki miniportu muszą przetwarzać żądania asynchroniczne i wysyłać zapytania, początkowo zwracając NDIS_STATUS_INDICATION_REQUIRED do oryginalnego żądania, a następnie wysyłając powiadomienie o stanie NDIS_STATUS_WWAN_RADIO_STATE zawierające strukturę NDIS_WWAN_RADIO_STATE, która wskazuje bieżący stan zasilania urządzenia MB niezależnie od ukończenia zestawu lub żądań zapytania.
Osoby wywołujące żądające ustawienia stanu zasilania radiowego urządzenia MB zapewniają strukturę NDIS_WWAN_SET_RADIO_STATE sterownikowi miniportu z odpowiednimi informacjami.
Uwagi
Aby uzyskać więcej informacji na temat korzystania z tego identyfikatora OID, zobacz MBstan radiowy .
Sterowniki miniportu nie powinny uzyskiwać dostępu do sieci dostawcy ani modułu tożsamości subskrybenta (karty SIM) podczas przetwarzania zapytań lub ustawiania operacji.
Sterowniki miniportu muszą zachować stany zasilania radiowego oprogramowania między ponownym uruchomieniem systemu lub usunięciem i ponownym uruchomieniem urządzenia. Sterowniki Miniport powinny przechowywać informacje radiowe o oprogramowaniu urządzenia i używać ich do ustawiania stanu zasilania radiowego oprogramowania urządzenia natychmiast na każdym ponownym uruchomieniu lub ponownym uruchomieniu urządzenia. Skuteczny stan zasilania radiowego urządzenia jest ustalany na podstawie kombinacji oprogramowania i sprzętowego stanu zasilania radiowego zgodnie z tabelą w WWAN_RADIO_STATE.
Jeśli wartość to WwanRadioOn, sterowniki miniportu muszą włączyć zasilanie radiowe i ustawić RadioState.SwRadioState elementu członkowskiego struktury WWAN_RADIO_STATE WwanRadioOn. Jeśli element RadioState.HwRadioState był WwanRadioOff, sterowniki miniportu powinny buforować te informacje o stanie zasilania i zapewnić fizyczne włączenie stanu zasilania radiowego, gdy RadioState.HwRadioState zmiany w WwanRadioOn.
Jeśli wartość to WwanRadioOff, sterowniki miniportu muszą wyłączyć stan zasilania radiowego i ustawić RadioState.SwRadioState elementu członkowskiego, aby WwanRadioOff.
Zapoznaj się z poniższą tabelą dotyczącą oczekiwanego programowania stanu radiowego przez sterowniki miniportów.
prawidłowe kombinacje dla trybu numeru PIN i stanu numeru PIN
| Wartość HwRadioState | Wartość elementu SwRadioState | Ogólny stan zasilania radiowego |
|---|---|---|
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOn |
WwanRadioOn |
W przypadku urządzeń, które nie zapewniają sprzętowego przełącznika radiowego, RadioState.HwRadioState składowej struktury NDIS_WWAN_RADIO_STATE musi być zawsze ustawiona na WwanRadioOn.
Począwszy od systemu Windows 10, wersja 1703, OID_WWAN_RADIO_STATE ma dodatkowe specyfikacje dotyczące sposobu obsługi konfiguracji stanu radiowego z systemu operacyjnego przez wielouczesny modem obsługiwany przez moduł wykonujący.
W przypadku modemu obsługiwanego przez funkcję wieloużytkową dostępne są zalety zasilania w celu skonfigurowania stanu zasilania radiowego na funkcję wykonawczą. Gdy radio funkcji wykonawczej jest wyłączone, system operacyjny oczekuje, że modem zostanie odwołany z sieci i nie podejmie próby skanowania ani aktualizacji lokalizacji. Modem powinien obsługiwać stan radiowy dla każdego wykonawcy, który anonsuje do systemu operacyjnego, aby mógł określić stan zasilania sprzętu, w którym powinien być.
Na przykład, jeśli modem ma dwie funkcje wykonawcze, a jeden z funkcji radiowych funkcji wykonawczych jest wyłączony, podczas gdy drugi jest włączony, modem może zachować fronton RF włączony, aby utrzymać rejestrację w funkcji wykonawczej, której radio jest włączone, ale nie musi wykonywać skanowania/pingowania/aktualizacji lokalizacji lub innych usług komórkowych dla funkcji wykonawczej, która jest wyłączona. Jeśli oba urządzenia radiowe są wyłączone, modem może wyłączyć fronton RF i przywrócić ogólny sprzęt do niższego stanu zasilania. Szczegóły implementacji są pozostawione do każdego IHV.
Wymagania
Wersja |
Dostępne w systemie Windows 7 i nowszych wersjach systemu Windows. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |