WWAN_READY_INFO-Struktur (wwan.h)

Artikel
02/27/2024

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.