OID_WWAN_VISIBLE_PROVIDERS

Artykuł
13.03.2025

OID_WWAN_VISIBLE_PROVIDERS zwraca listę dostawców sieci, które są obecnie widoczne w zakresie urządzenia MB.

Ustawianie żądań nie jest obsługiwane.

Sterowniki miniportu muszą przetwarzać żądania zapytań asynchronicznie, początkowo zwracając NDIS_STATUS_INDICATION_REQUIRED do oryginalnego żądania, a następnie wysyłając powiadomienie o stanie NDIS_STATUS_WWAN_VISIBLE_PROVIDERS zawierające strukturę NDIS_WWAN_VISIBLE_PROVIDERS, aby dostarczyć informacje o widocznych dostawców sieci podczas kończenia żądań zapytań.

Żądania zapytań określają strukturę NDIS_WWAN_GET_VISIBLE_PROVIDERS jako dane wejściowe. Gdy element członkowski akcji w WWAN_GET_VISIBLE_PROVIDERS jest ustawiony na WWAN_GET_VISIBLE_PROVIDERS_ALL miniport powinien zwrócić wszystkich widocznych dostawców. Gdy element członkowski akcji w WWAN_GET_VISIBLE_PROVIDERS jest ustawiony na WWAN_GET_VISIBLE_PROVIDERS_MULTICARRIER miniport powinien zwracać tylko widocznych dostawców z wieloma operatorami, którzy mogą być ustawiani jako dostawcy domu.

Widoczna lista dostawców zwrócona przez urządzenie powinna mieć prawidłowy stan dostawcy dla każdego dostawcy. Na przykład dostawcy preferowani przez multicarrier powinny być oznaczone jako WWAN_PROVIDER_STATE_PREFERRED_MULTICARRIER, bieżący dostawca domu, jeśli ma zostać oznaczony jako WWAN_PROVIDER_STATE_HOME, bieżący zarejestrowany dostawca, jeśli ma zostać oznaczony jako WWAN_PROVIDER_STATE_REGISTERED.

Rssi i ErrorRate składowych struktury WWAN_PROVIDER2 powinny być ustawiane, jeśli są dostępne.

Uwagi

Aby uzyskać więcej informacji na temat korzystania z tego identyfikatora OID, zobacz operacje dostawcy WWAN.

Sterowniki Miniport mogą uzyskiwać dostęp do modułu tożsamości subskrybenta (karty SIM) podczas przetwarzania operacji zapytań, ale nie powinny uzyskiwać dostępu do sieci dostawcy.

Sterowniki miniportu powinny ustawić element członkowski VisibleListHeader.ElementType na WwanStructProvider.

W przypadku sieci opartych na usłudze CDMA sterownik miniportu powinien zwrócić tylko dostawcę domu, jeśli którakolwiek z sieci na liście preferowanych roamingów (PRL) jest obecnie widoczna. W przypadku sieci opartych na sieciach GSM więcej niż jeden dostawca może znajdować się na liście widocznych dostawców.

Urządzenia, które nie obsługują skanowania widocznych dostawców, gdy są połączone, powinny zwracać wartość błędu WWAN_STATUS_BUSY w uStatus składowej struktury NDIS_WWAN_VISIBLE_PROVIDERS.

Zarówno urządzenia oparte na systemie GSM, jak i CDMA muszą obsługiwać skanowanie widocznych dostawców w trybie zarejestrowanym. Sterowniki miniportów nie są jednak wymagane do obsługi skanowania widocznego dostawcy, gdy kontekst protokołu PDP (Packet Data Protocol) jest aktywny (na przykład urządzenie jest połączone z siecią dostawcy).