OID_WWAN_PROVISIONED_CONTEXTS
OID_WWAN_PROVISIONED_CONTEXTS odczytuje lub aktualizuje zaaprowizowane wpisy kontekstu przechowywane na urządzeniu MB lub module tożsamości subskrybenta (SIM).
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_PROVISIONED_CONTEXTS zawierające strukturę NDIS_WWAN_PROVISIONED_CONTEXTS, aby dostarczyć informacje o aprowizowanych wpisach kontekstu przechowywanych na urządzeniu MB lub module tożsamości subskrybenta (SIM), niezależnie od kończenia zestawów lub żądań zapytań.
Uwagi
Aby uzyskać więcej informacji na temat korzystania z tego identyfikatora OID, zobacz zarządzanie kontekstem pakietów WWAN.
Sterowniki miniportu powinny zwrócić NDIS_STATUS_NOT_SUPPORTED, jeśli obsługiwane przez nie urządzenie MB nie obsługuje pobierania aprowiowanych kontekstów.
Urządzenia oparte na systemie GSM mogą opcjonalnie obsługiwać operacje zapytań i zestawów. Urządzenia oparte na usłudze CDMA mogą opcjonalnie obsługiwać operacje zapytań raportowania prostego adresu IP (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP).
Aprowizowane wpisy kontekstu przechowywane na urządzeniu MB lub karcie SIM są lokalne dla urządzenia. Sterowniki Miniport nie powinny łączyć się z siecią, aby odczytywać te pola.
Struktura danych wejściowych dla zestawu żądań jest NDIS_WWAN_SET_PROVISIONED_CONTEXT, a wskazanie stanu tego obiektu jest NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS.
Aprowizowane konteksty nie są takie same jak w przypadku definicji kontekstu GPRS w programie 3GPP, które buforują listę apNs. Aprowizowane konteksty to parametry łączności (AccessString, UserName i Password), które są wstępnie aprowidowane przez operatorów lub OTA aprowidowane przez urządzenie i mogą być przechowywane w pamięci urządzenia lub sim. Parametry łączności zwracane przez aprowizowane konteksty będą używane przez usługę MB na potrzeby aktywacji PDP.
Używane jest zarówno zapytanie, jak i formularz zestawu tego obiektu.
Przetwarzanie tego żądania nie wymaga dostępu do sieci, ale wymaga dostępu do karty SIM lub pamięci pomocniczej na urządzeniu MB.
Sterownik miniportu wysyła NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS powiadomienie do systemu operacyjnego. Element członkowski ContextListHeader.ElementType powinien być ustawiony na WwanStructContext. Sterownik Miniport powinien ustawić element członkowski ContextListHeader.ElementCount na wartość 0, gdy powiadomienie jest wysyłane w odpowiedzi na ustawione żądanie.
Usługa MB powinna pobrać listę zaaprowizowanych kontekstów z urządzenia przed przeprowadzeniem każdej indywidualnej aktywacji kontekstu lub dezaktywacji. Lista aprowizowanych kontekstów musi być ograniczona tylko do sieci dostawcy macierzystego, mimo że urządzenie może mieć możliwość przechowywania wielu kontekstów dostawcy sieci. Lista kontekstowa musi zawsze być siecią dostawcy macierzystego, nawet w przypadku roamingu.
Operacja SET OID_WWAN_PROVISIONED_CONTEXT powinna skojarzyć kontekst z dostawcą sieci określonym w żądaniu ustawionym w ProviderId elementu członkowskiego struktury WWAN_SET_CONTEXT. Aprowizowany kontekst przechowywany za pomocą zestawu OID_WWAN_PROVISIONED_CONTEXT żądań musi być utrwalany w przypadku ponownego uruchamiania systemu i odzyskiwania zasilania urządzenia.
Wszystkie puste konteksty muszą być zgłaszane w zapytaniu wraz z aprowizowanym kontekstami mającymi zastosowanie do sieci dostawcy macierzystego.
Urządzenia CDMA skonfigurowane pod kątem simpleIP, raportowanie w WWAN_CTRL_CAPS_CDMA_SIMPLE_IP w WwanControlCaps może opcjonalnie zwrócić co najmniej jeden aprowizowany kontekst wypełniony poprawnym AccessString, UserNamei hasła członków dla żądania zapytania z usługi MB.
Aprowizowana lista kontekstowa powinna być wstępnie aprowizowana na urządzeniu, aktualizowana przez operacje ustawiania OID_WWAN_PROVISIONED_CONTEXT lub aktualizowana przez urządzenie/operator przy użyciu programu SMS lub OTA. Nie może być aktualizowana dynamicznie na podstawie informacji kontekstowych podanych w operacji OID_WWAN_CONNECT przez usługę MB.
Aby uzyskać więcej informacji na temat uzyskiwania dostępu do funkcji AccessString, UserName i Password z urządzenia MB dla każdego kontekstu aprowizacji na liście, zobacz WWAN_CONTEXT.
Wymagania
Wersja |
Dostępne w systemie Windows 7 i nowszych wersjach systemu Windows. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |