WWAN_READY_INFO-Struktur (wwan.h)
Die WWAN_READY_INFO-Struktur stellt den Bereitschaftszustand 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;
Member
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 NULL-beendete Zeichenfolge von Ziffern, die die Identität des Abonnenten darstellt.
Bei GSM-basierten Geräten stellt dieses Element die IMSI-Zeichenfolge (International Mobile Subscriber Identity) dar (bis zu 15 Ziffern).
Bei CDMA-basierten Geräten stellt dies die Zeichenfolge Mobile Identification Number (MIN) oder die IRM-Zeichenfolge (International Roaming MIN) (beide 10 Ziffern lang) dar.
Miniporttreiber müssen diese Zeichenfolge angeben, wenn sich der Bereitzustand des Geräts in WwanReadyStateInitialized ändert. Miniport-Treiber sollten diese Zeichenfolge auch angeben, wenn sich der Bereitzustand des Geräts zu Identifizierungszwecken in WwanReadyStateBadSim, WwanReadyStateFailure oder WwanReadyStateDeviceLocked ändert.
Für Single-Carrier-Multimode-Funktionen muss das GSM-SubscriberId-Format verwendet werden. Dies gilt nicht für Multimode-Funktionen mit mehreren Trägern, da sich die Abonnenten-ID ändern kann.
SimIccId[WWAN_SIMICCID_LEN]
Eine NULL-endende Zeichenfolge von Ziffern, die die ICC-ID (International Circuit Card) der SIM 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 Bereitzustand des Geräts in WwanReadyStateInitialized ändert und das Gerät gesperrt ist und auf die Eingabe der PIN1- und PUK1-Schlüssel wartet.
Miniporttreiber müssen diesen Wert für alle Geräte angeben, auf denen WwanCellularClass gleich WwanCellularClassGsm ist. Miniporttreiber von CDMA-basierten Geräten müssen diesen Wert für Geräte angeben, auf denen SimClassgleich WwanSimClassSimRemovable ist.
CdmaShortMsgSize
Die vom Netzwerk oder dem Gerät unterstützte SMS-Zeichenlänge, je nachdem, welcher Wert kleiner ist, wenn das Gerät CDMA-basiert ist.
CDMA-basierte Geräte, die SMS unterstützen, sollten angeben, dass die mobilfunkanbieterspezifische maximale SMS-Zeichenlänge größer als WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN und kleiner als WWAN_CDMA_SHORT_MSG_SIZE_MAX ist.
CDMA-basierte Geräte, die SMS nicht unterstützen, sollten diesen Member 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-status-Flags.
| Wert | Bedeutung |
|---|---|
| WWAN_READY_STATUS_MASK_IS_ESIM 0x00000001 | 0: Die aktuelle SIM-Karte ist keine eSIM. 1: Die aktuelle SIM-Karte ist eine eSIM. Gültig nur, 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-Karte ist eingebettet. 1: Die aktuelle SIM-Karte kann entfernt werden. Ist nur gültig, wenn readyState MBIMSubscriberReadyStateInitialized, MBIMSubscriberReadyStateNoEsimProfile oder MBIMSubscriberReadyStateDeviceLocked ist. |
| WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 0x00000008 | 0: Der Hinweis stammt aus dem derzeit inaktiven Slot. 1: Die Angabe stammt aus dem derzeit 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 status Bits (außer WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE) ungültig sind. Wenn das Bit 0 ist, sind andere Bits ungültig und sollten ignoriert werden. Wenn das Bit 1 ist, sind andere status Bits gültig. |
SlotId
Ein ULONG-Wert, der die SIM-Karte Slot-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.
Jedes in einem Listenelement gespeicherte TN ist ein NULL-beendeter Wert.
In 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.
Miniporttreiber sollten diesen Wert erst angeben, wenn sich der Bereitzustand des Geräts in WwanReadyStateInitialized ändert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | wwan.h (include Wwan.h) |