OID_WWAN_READY_INFO
OID_WWAN_READY_INFO gibt den zustandsbereiten Gerät zurück, das sein Abonnentenidentitätsmodul (SIM-Karte) enthält. Dies geschieht in der Regel am Anfang jeder Sitzung.
Satzanforderungen werden nicht unterstützt.
Der Host kann den Ready-State entweder vom aktiven SIM-Steckplatz oder inaktiven SIM-Steckplatz auf dem Gerät abfragen, wenn das Gerät duale SIM-Steckplätze unterstützt. Die Nutzlast dieses 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, zunächst NDIS_STATUS_INDICATION_REQUIRED an die ursprüngliche Anforderung zurückgeben und später eine NDIS_STATUS_WWAN_READY_INFO Statusbenachrichtigung senden, die eine NDIS_WWAN_READY_INFO Struktur enthält, die den Ready-Zustand des MB-Geräts angibt, wenn Abfrageanforderungen abgeschlossen werden.
Bemerkungen
Weitere Informationen zur Verwendung dieses 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.
Miniport-Treiber sollten warten, bis die PIN gelöscht wird (falls erforderlich), und dann die Identität und Telefonnummern des Abonnenten (TNs) lesen und dann das ReadyInfo.ReadyState-Mitglied der NDIS_WWAN_READY_INFO Struktur auf WwanReadyStateInitialized festlegen.
Miniport-Treiber dürfen niemals OID_WWAN_READY_INFO fehlschlagen und müssen immer den richtigen Gerätezustand zurückgeben.
Miniporttreiber müssen den MB-Dienst immer benachrichtigen, wenn sich der Gerätezustand ä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 WwanReadyStateDeviceLockedfestgelegt ist. Der MB-Dienst sendet dann dem Miniporttreiber 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 WwanReadyStateInitializedfestgelegt ist. Bis PIN1 erfolgreich entsperrt wurde, dürfen Miniporttreiber den Geräte-Ready-Zustand nicht in WwanReadyStateInitializedändern.
Miniport-Treiber müssen zuerst eine Ereignisbenachrichtigung mit ReadyInfo.ReadyState auf WwanReadyStateSimNotInserted, wenn der MB-Dienst den Miniporttreiber lädt, wenn keine SIM-Karte vorhanden ist, wie es bei Geräten der Fall sein kann, mit denen SIM-Karten eingefügt oder entfernt werden können. Wenn das Gerät die Möglichkeit hat, eine heiße Einfügung einer SIM-Karte zu erkennen, muss der Miniporttreiber eine weitere Ereignisbenachrichtigung senden, wobei ReadyInfo.ReadyState auf WwanReadyStateInitialized festgelegt ist, wenn der Benutzer eine SIM einfügt.
Geräte, die über die Funktion zum Erkennen des Dienstaktivierungsstatus verfügen, müssen ReadyInfo.ReadyState auf WwanReadyStateNotActivatedfestlegen. Wenn der Miniporttreiber die Dienstaktivierung unterstützt, erhält der Miniporttreiber außerdem eine OID-Setanforderung von OID_WWAN_SERVICE_ACTIVATION. Nach erfolgreichem Abschluss der Dienstaktivierung müssen Miniporttreiber eine weitere Ereignisbenachrichtigung senden, wobei ReadyInfo.ReadyState auf WwanReadyStateInitializedfestgelegt ist.
Miniporttreiber, 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 sie ReadyInfo.ReadyState auf WwanReadyStateFailurefestlegen.
Anforderungen
Version: Verfügbar in Windows 7 und höheren Versionen von Windows.
Header-: Ntddndis.h (include Ndis.h)