OID_WWAN_READY_INFO
OID_WWAN_READY_INFO gibt den Bereit-Zustand des Geräts zurück, der das Abonnentenidentitätsmodul (SIM-Karte) enthält. Dies tritt in der Regel am Anfang einer sitzung auf.
Set-Anforderungen werden nicht unterstützt.
Der Host kann den Bereit-Zustand entweder über den aktiven SIM-Steckplatz oder den inaktiven SIM-Steckplatz im Gerät abfragen, wenn das Gerät duale SIM-Steckplätze unterstützt. Die Nutzlast dieser OID enthält eine NDIS_WWAN_QUERY_READY_INFO-Struktur , die wiederum eine WWAN_QUERY_READY_INFO-Struktur enthält, die die UICC-Slot-ID angibt.
Miniport-Treiber müssen Abfrageanforderungen asynchron verarbeiten und zunächst NDIS_STATUS_INDICATION_REQUIRED an die ursprüngliche Anforderung zurückgeben und später eine NDIS_STATUS_WWAN_READY_INFO status Benachrichtigung senden, die eine NDIS_WWAN_READY_INFO-Struktur enthält, die den Bereitzustand des MB-Geräts beim Abschließen von Abfrageanforderungen angibt.
Bemerkungen
Weitere Informationen zur Verwendung dieser OID finden Sie unter MB-Gerätebereitschaft.
Miniport-Treiber können beim Verarbeiten von Abfragevorgängen auf den Gerätespeicher oder die SIM-Karte zugreifen, sollten jedoch nicht auf das Anbieternetzwerk zugreifen.
Miniporttreiber sollten warten, bis die PIN gelöscht wurde (falls erforderlich), und dann die Identität und Telefonnummern (TNs) des Abonnenten lesen und dann das ReadyInfo.ReadyState-Element der NDIS_WWAN_READY_INFO-Struktur auf WwanReadyStateInitialized festlegen.
Miniport-Treiber dürfen nie fehlschlagen OID_WWAN_READY_INFO und müssen immer den richtigen Betriebszustand des Geräts zurückgeben.
Miniport-Treiber müssen den MB-Dienst immer benachrichtigen, wenn sich der Betriebszustand des Geräts ändert.
Miniport-Treiber sollten die folgenden Schritte ausführen, um eine gute Benutzererfahrung zu bieten:
Wenn PIN1 gesperrt ist, müssen Miniporttreiber zuerst eine Ready-State-Ereignisbenachrichtigung senden, wobei ReadyInfo.ReadyState auf WwanReadyStateDeviceLocked festgelegt ist. Der MB-Dienst sendet dem Miniporttreiber dann eine OID-Set-Anforderung von OID_WWAN_PIN. Nachdem das Gerät entsperrt wurde, muss der Miniporttreiber eine weitere Ready-State-Ereignisbenachrichtigung senden, wobei ReadyInfo.ReadyState auf WwanReadyStateInitialized festgelegt ist. Bis PIN1 erfolgreich entsperrt wurde, dürfen Miniporttreiber den Gerätezustand ready-state nicht in WwanReadyStateInitialized ändern.
Miniport-Treiber müssen zunächst eine Ereignisbenachrichtigung senden, bei der ReadyInfo.ReadyState auf WwanReadyStateSimNotInserted festgelegt ist, wenn der MB-Dienst den Miniporttreiber lädt, wenn kein SIM-Karte vorhanden ist, wie es bei Geräten der Fall ist, die das Ein- oder Entfernen von SIM-Karten ermöglichen. Wenn das Gerät in der Lage ist, ein heißes Einfügen einer SIM-Karte zu erkennen, muss der Miniporttreiber eine weitere Ereignisbenachrichtigung senden, bei der ReadyInfo.ReadyState auf WwanReadyStateInitialized festgelegt ist, wenn der Benutzer eine SIM einfügt.
Geräte, die über die Fähigkeit verfügen, den Dienstaktivierungsstatus zu erkennen, müssen ReadyInfo.ReadyState auf WwanReadyStateNotActivated festlegen. Wenn der Miniporttreiber die Dienstaktivierung unterstützt, erhält der Miniporttreiber außerdem eine OID-Set-Anforderung von OID_WWAN_SERVICE_ACTIVATION. Nach erfolgreichem Abschluss der Dienstaktivierung müssen Miniporttreiber eine weitere Ereignisbenachrichtigung senden, wobei ReadyInfo.ReadyState auf WwanReadyStateInitialized festgelegt ist.
Miniport-Treiber, die eine bestimmte Firmwarerevision erfordern, müssen sicherstellen, dass die richtige Firmwarerevision verfügbar ist. Wenn die Firmwarerevision nicht verfügbar ist, sollte der Miniporttreiber die Ereignisbenachrichtigungstransaktion abschließen, indem ReadyInfo.ReadyState auf WwanReadyStateFailure festgelegt wird.
Anforderungen
Version: Verfügbar in Windows 7 und höheren Versionen von Windows.
Header: Ntddndis.h (include Ndis.h)