WWAN_DEVICE_CAPS_EX-Struktur (wwan.h)

Die WWAN_DEVICE_CAPS_EX-Struktur stellt die Funktionen des mobilen Breitbandgeräts dar. WWAN_DEVICE_CAPS_EX erweitert die vorhandene WWAN_DEVICE_CAPS-Struktur , indem ein Executor Index-Member für die Nachverfolgung bestimmter Executors und ein WwanOptionalServiceCaps-Member für Microsoft-Diensterweiterungen hinzugefügt werden.

Syntax

typedef struct _WWAN_DEVICE_CAPS_EX {
  WWAN_DEVICE_TYPE    WwanDeviceType;
  WWAN_CELLULAR_CLASS WwanCellularClass;
  WWAN_VOICE_CLASS    WwanVoiceClass;
  WWAN_SIM_CLASS      WwanSimClass;
  ULONG               WwanDataClass;
  WCHAR               CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN];
  ULONG               WwanGsmBandClass;
  ULONG               WwanCdmaBandClass;
  WCHAR               CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN];
  ULONG               WwanSmsCaps;
  ULONG               WwanControlCaps;
  WCHAR               DeviceId[WWAN_DEVICEID_LEN];
  WCHAR               Manufacturer[WWAN_MANUFACTURER_LEN];
  WCHAR               Model[WWAN_MODEL_LEN];
  WCHAR               FirmwareInfo[WWAN_FIRMWARE_LEN];
  ULONG               MaxActivatedContexts;
  ULONG               WwanAuthAlgoCaps;
  ULONG               ExecutorIndex;
  ULONG               WwanOptionalServiceCaps;
  ULONG               WwanSimClassBitMasks;
  ULONG               WwanWCDMABandClass;
  USHORT              WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND];
  USHORT              WwanNRBandClass[WWAN_MAX_NUM_NR_BAND];
  ULONGLONG           WwanDataSubClass;
  ULONGLONG           WwanMiscCaps;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX, *PWWAN_DEVICE_CAPS_EX;

Member

WwanDeviceType

Der Typ des Geräts. Miniport-Treiber müssen den Gerätetyp auf einen anderen Wert als WwanDeviceTypeUnknown festlegen.

WwanCellularClass

Die Mobilfunkklasse des Geräts. Miniport-Treiber müssen die Mobilfunkklasse auf einen anderen Wert als WwanCellularClassUnknown festlegen. Die Werte in diesem Member steuern Features, die für die Mobilfunktechnologie spezifisch sind, z. B. Registrierungsmodi für Netzwerkanbieter.

Miniport-Treiber, die multi-mode unterstützen, sollten dies auf WwanCellularClassGsm festlegen.

WwanVoiceClass

Die Sprachklasse des Geräts. Dieses Mitglied informiert den MB-Dienst über das Vorhandensein des Leitungs-VoIP-Diensts und darüber, wie dieser Dienst mit dem Datendienst interagiert. Beachten Sie, dass der MB-Dienst keine nativ umgeschaltete Stimme unterstützt und dies auch nicht ausschließt. Es liegt am Miniporttreiber, zu bestimmen, wie die Leitungsstimme unterstützt werden soll. Dieses WwanVoiceClass-Element ermöglicht es dem MB-Dienst, dieses Feature in Zukunft zu unterstützen.

WwanSimClass

Die Klasse des Abonnentenidentitätsmoduls (SIM-Karte), das von der WWAN_SIM_CLASS-Enumeration angegeben wird. Miniport-Treiber müssen die SIM-Klasse auf einen anderen Wert als WwanSimClassUnknown festlegen.

WwanDataClass

Eine Bitmap, die die vom Gerät unterstützten Datenklassen darstellt. Die folgende Tabelle zeigt die möglichen Werte für diesen Member.

CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]

Eine MIT NULL beendete Zeichenfolge, die den Namen der benutzerdefinierten Datenklasse darstellt. Dieser Member ist nur gültig, wenn der Miniporttreiber das WWAN_DATA_CLASS_CUSTOM Bit im WwanDataClass-Element festlegt.

WwanGsmBandClass

Eine Bitmap, die die Frequenzbänder darstellt, die GSM-basierte Geräte unterstützen. Die folgende Tabelle zeigt die möglichen Werte für diesen Member.

Wenn der Miniporttreiber WWAN_BAND_CLASS_CUSTOM angibt, sollte er auch den Namen der Datenklasse in CustomBandClass angeben.

Weitere Informationen zu diesen Werten finden Sie unter OID_WWAN_DEVICE_CAPS.

WwanCdmaBandClass

Eine Bitmap, die die Frequenzbänder darstellt, die CDMA-basierte Geräte unterstützen. Die folgende Tabelle zeigt die möglichen Werte für diesen Member.

Wenn der Miniporttreiber WWAN_BAND_CLASS_CUSTOM angibt, sollte er auch den Namen der Datenklasse in CustomBandClass angeben.

Weitere Informationen zu diesen Werten finden Sie unter OID_WWAN_DEVICE_CAPS.

CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN]

Eine MIT NULL beendete Zeichenfolge, die den Namen der benutzerdefinierten Bandklasse darstellt. Dieser Member ist nur gültig, wenn der Miniporttreiber das WWAN_BAND_CLASS_CUSTOM Bit entweder in den WwanGsmBandClass - oder WwanCdmaBandClass-Membern festlegt.

WwanSmsCaps

Eine Bitmap, die den Typ von SMS-Nachrichten und den vom Gerät unterstützten richtungsgerichteten Fluss darstellt. In der folgenden Tabelle sind die gültigen Einstellungen für SMS-Funktionen aufgeführt.

Miniport-Treiber sollten dieses Element so einstellen, dass nur das GSM-PDU-Format für den Empfang und das Senden von SMS unterstützt wird, wenn der aktuelle Home-Anbieter multimodusfähig ist. Wenn der Miniporttreiber eine SMS im nativen Format der Mobilfunkklasse empfängt, z. B. CDMA TEXT oder CDMA PDU, muss der Miniporttreiber die Übersetzung in gsm-PDU durchführen und dem MB-Dienst mitteilen. Wenn der Miniporttreiber eine Sendeanforderung im GSM-PDU-Format empfängt, muss er die Übersetzung in sein natives Mobilfunkklassenformat durchführen.

WwanControlCaps

Eine Bitmap, die die Vom Gerät unterstützten Steuerelementfunktionen darstellt. In der folgenden Tabelle sind die gültigen WwanControlCaps-Einstellungen für GSM- und CDMA-basierte Geräte aufgeführt.

Miniporttreiber von CDMA-basierten Geräten müssen WWAN_CTRL_CAPS_CDMA_MOBILE_IP oder WWAN_CTRL_CAPS_CDMA_SIMPLE_IP oder beide Flags angeben, um den MB-Dienst über den vom Gerät unterstützten IP-Typ zu informieren.

DeviceId[WWAN_DEVICEID_LEN]

Eine NULL-endende Zeichenfolge, die die Geräte-ID darstellt.

Bei GSM-basierten Geräten muss die Zeichenfolge dem ImEI-Format (International Mobile Equipment Identity) entsprechen (bis zu 15 Ziffern).

Bei CDMA-basierten Geräten muss die Zeichenfolge den Formaten Elektronische Seriennummer (ESN, 11 Ziffern) und Mobile Equipment Identifier (MEID, 17 Ziffern) entsprechen.

Für Multi-Mode-fähige Miniporttreiber, z. B. solche, die das WWAN_CTRL_CAPS_MULTI_MODE-Flag in WwanControlCaps festlegen, muss nur die GSM-basierte DeviceId gemeldet werden.

Dieser Wert sollte im Speicher des Geräts gespeichert werden und muss auch dann verfügbar sein, wenn für das MB-Gerät/die SIM-Karte eine PIN zum Entsperren erforderlich ist.

Manufacturer[WWAN_MANUFACTURER_LEN]

Eine NULL-endende Zeichenfolge, die den Hersteller des Geräts darstellt. Dieses Member ist optional.

Model[WWAN_MODEL_LEN]

Eine NULL-endende Zeichenfolge, die das Modell des Geräts darstellt. Dieses Member ist optional.

FirmwareInfo[WWAN_FIRMWARE_LEN]

Eine NULL-endende Zeichenfolge, die die firmwarespezifischen Informationen zum Gerät darstellt. Dieses Member ist optional.

MaxActivatedContexts

Die maximale Anzahl aktivierter Kontexte, die vom Gerät unterstützt werden. Miniport-Treiber sollten diesen Grenzwert erzwingen, indem sie bei aktivierungsversuchen, die MaxActivatedContexts überschreiten, fehlschlagen.

WwanAuthAlgoCaps

Eine Bitmap, die die Typen von Authentifizierungsmethoden darstellt, die vom MB-Gerät unterstützt werden.

ExecutorIndex

Der WwanDeviceType-Member für WWAN_DEVICE_CAPS_EX bezieht sich nicht mehr auf das Modemgerät, sondern auf einen einzelnen Executor. Jedes Gerät ist eine RF-Executorentität, die dem Betriebssystem bekannt ist.

WwanOptionalServiceCaps

Eine ULONG-Struktur, die die Microsoft-Diensterweiterungen darstellt, die das zugrunde liegende Modem unterstützt. Es handelt sich um eine 64-Bit-Bitmapstruktur, deren undefinierte Bits reserviert sind und auf "0" festgelegt werden müssen. Wenn neue Diensterweiterungen eingeführt werden, werden die reservierten Bits verwendet, um die neuen Diensterweiterungen darzustellen.

WwanSimClassBitMasks

Eine Bitmap, die SIM-Klassenmasken darstellt. Sie muss mindestens die Maske enthalten, die dem Feld WwanSimClass entspricht.

WwanWCDMABandClass

Die in 3GPP TS25.101 für FDD definierte Bandnummer. Der LSB gibt die Bandnummer 1 (2100 MHz) an.

WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND]

WwanNRBandClass[WWAN_MAX_NUM_NR_BAND]

WwanDataSubClass

Eine Bitmap, die die Vom Gerät unterstützten Datenunterklassen darstellt.

WwanMiscCaps

Eine Bitmap, die verschiedene Funktionen darstellt, die das Gerät unterstützt. |Wert| |--- | |WWAN_DEVICE_MISC_CAPS_NONE 0x00000000| |WWAN_DEVICE_MISC_CAPS_ETHERNET_PDU_SESSION 0x00000001| |WWAN_DEVICE_MISC_CAPS_UNSTRUCTURED_PDU_SESSION 0x00000002| |WWAN_DEVICE_MISC_CAPS_ESIM 0x00000004| |WWAN_DEVICE_MISC_CAPS_REFLECTIVE_QOS 0x00000008|

CellularClassListHeader

Ein formatiertes WWAN_LIST_HEADER-Objekt, das eine Liste von Mobilfunkklassen darstellt, die von einem Multimodus-fähigen Gerät unterstützt werden. Das ElementType-Element in WWAN_LIST_HEADER sollte immer auf WwanStructCellularClass festgelegt werden. Das ElementCount-Element in WWAN_LIST_HEADER ist auf die Anzahl der Mobilfunkklassen festgelegt, die der WWAN_LIST_HEADER-Struktur folgen. MB-Geräte, die nicht multimodusfähig sind, sollten ElementCount auf 0 festlegen.

Hinweise

Miniport-Treiber sollten WWAN_DATA_CLASS_CUSTOM angeben, wenn der vom Gerät unterstützte Datendienst nicht zu einem der anderen Werte gehört, die in der Tabelle für den WwanDataClass-Member definiert sind. Wenn ein Miniporttreiber das flag WWAN_DATA_CLASS_CUSTOM festlegt, sollte der Miniporttreiber auch den Namen der Datenklasse im CustomDataClass-Element angeben.

Für GSM-basierte Geräte müssen nur GSM-basierte Datenklassen angegeben werden. Beispiel: GPRS, EDGE, UMTS, HSDPA, LTE und TD-SCDMA. Wenn Ihr Miniporttreiber TD-SCDMA unterstützt, sollte er WWAN_DATA_CLASS_CUSTOM im WwanDataClass-Member und die Zeichenfolge "TD-SCDMA" im CustomDataClass-Member angeben.

Für CDMA-basierte Geräte müssen nur CDMA-bezogene Datendienste angegeben werden. Beispiel: 1xRTT, 1xEV-DO, 1xEV-DO RevA und UMB. 1xEV-DO RevB ist für die zukünftige Verwendung definiert. 1xEV-DV und 3xRTT sind ebenfalls auf Vollständigkeit festgelegt.

Anforderungen

Weitere Informationen

NDIS_WWAN_DEVICE_CAPS_EX

OID_WWAN_DEVICE_CAPS_EX

WWAN_DEVICE_CAPS