WWAN_READY_INFO_REV2_PRE2170-Struktur (wwan.h)
Die WWAN_READY_INFO_REV2_PRE2170-Struktur ist die ältere Version der WWAN_READY_INFO-Struktur vor Windows 11.
Syntax
typedef struct _WWAN_READY_INFO_REV2_PRE2170 {
WWAN_READY_STATE ReadyState;
WWAN_EMERGENCY_MODE EmergencyMode;
WCHAR SubscriberId[WWAN_SUBSCRIBERID_LEN];
WCHAR SimIccId[WWAN_SIMICCID_LEN];
BYTE CdmaShortMsgSize;
ULONG StatusFlags;
WWAN_LIST_HEADER TNListHeader;
} WWAN_READY_INFO_REV2_PRE2170, *PWWAN_READY_INFO_PRE2170;
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-endende Zeichenfolge von Ziffern, die die Identität des Abonnenten darstellt.
Für GSM-basierte Geräte stellt dieses Element die IMSI-Zeichenfolge (International Mobile Subscriber Identity) dar (bis zu 15 Ziffern lang).
Bei CDMA-basierten Geräten stellt dies die MIN-Zeichenfolge (Mobile Identification Number) oder die IRM-Zeichenfolge (International Roaming MIN) dar (beide 10 Ziffern lang).
Miniport-Treiber müssen diese Zeichenfolge angeben, wenn sich der Bereit-Zustand 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-Multimodusfunktionen muss das GSM-SubscriberId-Format verwendet werden. Dies gilt nicht für Multi-Carrier-Multimodusfunktionen, da sich die SubscriberId ändern kann.
SimIccId[WWAN_SIMICCID_LEN]
Eine NULL-endende Zeichenfolge von Ziffern, die die ID der Internationalen Circuit Card (ICC) 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 Bereitzustand des Geräts in WwanReadyStateInitialized ändert und das Gerät gesperrt ist und auf die Eingabe der PIN1- und PUK1-Schlüssel wartet.
Miniport-Treiber 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, bei denen SimClass gleich WwanSimClassSimRemovable ist.
CdmaShortMsgSize
Die LÄNGE von SMS-Zeichen, 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 anbieterspezifische maximale SMS-Zeichenlänge angeben, um größer als WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN und kleiner als WWAN_CDMA_SHORT_MSG_SIZE_MAX zu sein.
CDMA-basierte Geräte, die SMS nicht unterstützen, sollten dieses Element 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. 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-Karte ist eingebettet. 1: Die aktuelle SIM-Karte ist entfernbar. Nur gültig, wenn ReadyState MBIMSubscriberReadyStateInitialized, MBIMSubscriberReadyStateNoEsimProfile oder MBIMSubscriberReadyStateDeviceLocked ist. |
| WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 0x00000008 | 0: Die Angabe 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 (mit Ausnahme von 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. |
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-endender 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.
Miniport-Treiber sollten diesen Wert erst angeben, wenn sich der Bereitzustand des Geräts in WwanReadyStateInitialized ändert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | wwan.h |