OID_WWAN_PROVISIONED_CONTEXTS
OID_WWAN_PROVISIONED_CONTEXTS liest oder aktualisiert die bereitgestellten Kontexteinträge, die auf dem MB-Gerät oder im Subscriber Identity Module (SIM) gespeichert sind.
Miniport-Treiber müssen Satz- und Abfrageanforderungen asynchron verarbeiten, zunächst NDIS_STATUS_INDICATION_REQUIRED an die ursprüngliche Anforderung zurückgeben und später eine NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS Statusbenachrichtigung senden, die eine NDIS_WWAN_PROVISIONED_CONTEXTS Struktur enthält, um Informationen zu bereitgestellten Kontexteinträgen bereitzustellen, die auf dem MB-Gerät oder dem Subscriber Identity Module (SIM) gespeichert sind, unabhängig vom Abschließen von Satz- oder Abfrageanforderungen.
Bemerkungen
Weitere Informationen zur Verwendung dieses OID finden Sie unter WWAN Packet Context Management.
Miniport-Treiber sollten NDIS_STATUS_NOT_SUPPORTED zurückgeben, wenn das von ihnen unterstützten MB-Gerät das Abrufen von bereitgestellten Kontexten nicht unterstützt.
GSM-basierte Geräte können optional Abfragen und Festlegen von Vorgängen unterstützen. CDMA-basierte Geräte können optional Abfragevorgänge unterstützen, die einfache IP (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP) melden.
Die bereitgestellten Kontexteinträge, die auf dem MB-Gerät oder der SIM gespeichert sind, sind lokal auf dem Gerät. Miniport-Treiber sollten keine Verbindung mit dem Netzwerk herstellen, um in diesen Feldern zu lesen.
Die Eingabestruktur für eine set-Anforderung ist NDIS_WWAN_SET_PROVISIONED_CONTEXT und die Statusanzeige dieses Objekts ist NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS.
Bereitgestellte Kontexte sind nicht mit der der GPRS-Kontextdefinitionen in 3GPP identisch, die die Liste der APNs zwischenspeichert. Bereitgestellte Kontexte sind die Verbindungsparameter (AccessString, UserName und Password), die entweder von den Operatoren oder von OTA bereitgestellt werden, die vom Gerät bereitgestellt werden und entweder im Gerätespeicher oder im SIM-Speicher gespeichert werden können. Die von den bereitgestellten Kontexten zurückgegebenen Verbindungsparameter werden vom MB-Dienst für die PDP-Aktivierung verwendet.
Sowohl Abfrage- als auch Satzform dieses Objekts wird verwendet.
Die Verarbeitung dieser Anforderung erfordert keinen Netzwerkzugriff, erfordert jedoch Zugriff auf die SIM- oder Hilfsspeicher auf dem MB-Gerät.
Der Miniporttreiber sendet NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS Benachrichtigung an das Betriebssystem. Der ContextListHeader.ElementType Member muss auf WwanStructContext-festgelegt werden. Der Miniport-Treiber sollte den ContextListHeader.ElementCount Member auf 0 festlegen, wenn die Benachrichtigung als Reaktion auf eine festgelegte Anforderung gesendet wird.
Der MB-Dienst sollte die Liste der bereitgestellten Kontexte vom Gerät abrufen, bevor eine einzelne Kontextaktivierung oder Deaktivierung durchgeführt wird. Die Liste der bereitgestellten Kontexte darf nur auf das Heimanbieternetzwerk beschränkt werden, obwohl das Gerät möglicherweise über die Möglichkeit verfügt, mehrere Netzwerkanbieterkontexte zu speichern. Die Kontextliste muss immer das Heimanbieternetzwerk sein, das auch bei Roaming spezifisch ist.
DER SET-OID_WWAN_PROVISIONED_CONTEXT-Vorgang sollte den Kontext dem Netzwerkanbieter zuordnen, der in der Setanforderung in ProviderId Mitglied der WWAN_SET_CONTEXT-Struktur angegeben ist. Der bereitgestellte Kontext, der über festgelegte OID_WWAN_PROVISIONED_CONTEXT Anforderungen gespeichert wird, muss über Systemneustarts hinweg beibehalten werden, und Geräteleistung wird wiederverwendet.
Alle leeren Kontexte müssen in einer Abfrage zusammen mit den bereitgestellten Kontexten gemeldet werden, die für das Heimanbieternetzwerk gelten.
CDMA-Geräte, die für SimpleIP konfiguriert sind, die Berichterstellung in WWAN_CTRL_CAPS_CDMA_SIMPLE_IP in WwanControlCaps kann optional mindestens einen bereitgestellten Kontext zurückgeben, der mit dem richtigen AccessString-, UserNameund Password Member für die Abfrageanforderung von MB Service gefüllt ist.
Die bereitgestellte Kontextliste sollte auf dem Gerät vorab bereitgestellt, aktualisiert werden, indem OID_WWAN_PROVISIONED_CONTEXT Vorgänge festgelegt oder vom Gerät/Operator mithilfe von SMS oder OTA aktualisiert werden. Sie darf nicht dynamisch aktualisiert werden, basierend auf den Kontextinformationen, die im OID_WWAN_CONNECT Vorgang von MB Service bereitgestellt werden.
Weitere Informationen zum Zugreifen auf AccessString, UserName und Password vom MB-Gerät für jeden bereitgestellten Kontext in der Liste finden Sie unter WWAN_CONTEXT.
Anforderungen
Version |
Verfügbar in Windows 7 und höheren Versionen von Windows. |
Kopfball |
Ntddndis.h (include Ndis.h) |