WWAN_READY_INFO_REV2_PRE2170-Struktur (wwan.h)

  • Artikel

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

Weitere Informationen

WWAN_READY_INFO