WWAN_READY_INFO Struktur (wwan.h)
Die WWAN_READY_INFO Struktur stellt den Ready-State des MB-Geräts dar.
Syntax
typedef struct _WWAN_READY_INFO {
WWAN_READY_STATE ReadyState;
WWAN_EMERGENCY_MODE EmergencyMode;
WCHAR SubscriberId[WWAN_SUBSCRIBERID_LEN];
WCHAR SimIccId[WWAN_SIMICCID_LEN];
BYTE CdmaShortMsgSize;
ULONG StatusFlags;
ULONG SlotId;
WWAN_LIST_HEADER TNListHeader;
} WWAN_READY_INFO, *PWWAN_READY_INFO;
Angehörige
ReadyState
Der bereite Zustand des Geräts.
EmergencyMode
Der Notfallmodus des Geräts. Weitere Informationen finden Sie unter WWAN_EMERGENCY_MODE.
SubscriberId[WWAN_SUBSCRIBERID_LEN]
Eine MIT NULL beendete Zeichenfolge mit Ziffern, die die Identität des Abonnenten darstellt.
Bei GSM-basierten Geräten stellt dieses Mitglied die IMSI-Zeichenfolge (International Mobile Subscriber Identity) (bis zu 15 Ziffern länge) dar.
Bei CDMA-basierten Geräten stellt dies die MIN-Zeichenfolge (Mobile Identification Number) oder die IRM-Zeichenfolge (International Roaming MIN) (beide 10 Ziffern lang) dar.
Miniport-Treiber müssen diese Zeichenfolge angeben, wenn sich der Zustand des Geräts in WwanReadyStateInitializedändert. Miniport-Treiber sollten diese Zeichenfolge auch angeben, wenn sich der Zustand des Geräts in WwanReadyStateBadSim, WwanReadyStateFailureoder WwanReadyStateDeviceLocked, falls möglich, zu Identifikationszwecken ändert.
Für Multimodusfunktionen mit einem Netzbetreiber muss die GSM SubscriberId Format verwendet werden. Dies gilt nicht für Multi-Carrier-Multi-Mode-Funktionen, da sich die SubscriberId ändern kann.
SimIccId[WWAN_SIMICCID_LEN]
Eine NULL-beendete Zeichenfolge mit Ziffern, die die INTERNATIONAL Circuit Card (ICC)-ID der SIM-Karte darstellt. Die ICC-ID variiert zwischen 15 und 20 Ziffern und wird in alphanumerischen Zeichen dargestellt. Miniport-Treiber müssen diese Zeichenfolge angeben, wenn sich der Zustand des Geräts in WwanReadyStateInitialized ändert und auch, wenn das Gerät gesperrt ist und auf den Eintrag von PIN1- und PUK1-Schlüsseln wartet.
Miniport-Treiber müssen diesen Wert für alle Geräte angeben, auf denen WwanCellularClass gleich WwanCellularClassGsmist. Miniport-Treiber von CDMA-basierten Geräten müssen diesen Wert für Geräte angeben, auf denen SimClass gleich WwanSimClassSimRemovableist.
CdmaShortMsgSize
Die Länge des SMS-Zeichens, die vom Netzwerk oder gerät unterstützt wird, je nachdem, welcher Wert kleiner ist, wenn das Gerät CDMA-basiert.
CDMA-basierte Geräte, die SMS unterstützen, sollten ihre netzbetreiberspezifische maximale SMS-Zeichenlänge angeben, die größer als WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN und kleiner als WWAN_CDMA_SHORT_MSG_SIZE_MAX sein soll.
CDMA-basierte Geräte, die SMS nicht unterstützen, sollten dieses Mitglied auf WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN festlegen.
Dieses Mitglied gilt nicht für GSM-basierte Geräte. Miniporttreiber von GSM-basierten Geräten sollten WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN angeben.
StatusFlags
SIM-Statuskennzeichnungen.
| Wert | Bedeutung |
|---|---|
| WWAN_READY_STATUS_MASK_IS_ESIM 0x00000001 | 0: Die aktuelle SIM ist kein eSIM. 1: Die aktuelle SIM ist ein eSIM. Nur gültig, wenn "ReadyState" MBIMSubscriberReadyStateInitialized oder MBIMSubscriberReadyStateNoEsimProfile ist. |
| WWAN_READY_STATUS_MASK_SIM_REMOVABILITY_KNOWN 0x00000002 | 0: SIM-Entfernbarkeit ist unbekannt. 1: SIM-Entfernbarkeit ist bekannt. |
| WWAN_READY_STATUS_MASK_SIM_FORMFACTOR 0x00000004 | 0: Die aktuelle SIM ist eingebettet. 1: Die aktuelle SIM ist wechselbar. Nur gültig, wenn "ReadyState" MBIMSubscriberReadyStateInitialized, MBIMSubscriberReadyStateNoEsimProfile oder MBIMSubscriberReadyStateDeviceLocked ist. |
| WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 0x00000008 | 0: Die Angabe stammte aus dem derzeit inaktiven Slot. 1: Die Angabe stammte aus dem aktuell aktiven Slot. Dieses Bit kann unabhängig vom WWAN_READY_STATUS_MASK_MASKS_IS_VALID Bit festgelegt werden. |
| WWAN_READY_STATUS_MASK_MASKS_IS_VALID 0x80000000 | Gibt an, ob andere Statusbits (mit Ausnahme von WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE) ungültig sind. Wenn das Bit 0ist, sind andere Bits ungültig und sollten ignoriert werden. Wenn das Bit 1ist, sind andere Statusbits gültig. |
SlotId
Ein ULONG-Wert, der die SIM-Kartensteckplatz-ID angibt.
TNListHeader
Eine Liste der Telefonnummern (TNs), die der Abonnentenidentität zugewiesen sind.
Jedes Element in der Liste ist eine Zeichenfolge von WCHARs mit einer festen Größe von WWAN_TN_LEN.
Jeder in einem Listenelement gespeicherte TN ist ein NULL-beendeter Wert.
Auf GSM-basierten Geräten werden die TNs als Mobile Station ISDN Number (MSISDNs) bezeichnet. Auf CDMA-basierten Geräten werden sie als Mobile Directory Numbers (MDNs) bezeichnet.
Miniport-Treiber sollten diesen Wert erst angeben, wenn sich der Zustand des Geräts in WwanReadyStateInitializedändert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Header- | wwan.h (include Wwan.h) |