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)

Weitere Informationen

NDIS_WWAN_READY_INFO

WWAN_EMERGENCY_MODE

WWAN_LIST_HEADER

WWAN_READY_STATE