WWAN_DEVICE_CAPS_EX_REV1-Struktur (wwan.h)

Die WWAN_DEVICE_CAPS_EX_REV1-Struktur stellt die Funktionen eines mobilen Breitbandgeräts dar. WWAN_DEVICE_CAPS_EX_REV1 aktualisiert die vorhandene WWAN_DEVICE_CAPS_EX-Struktur , indem Sie die folgenden Felder entfernen:

• WwanSimClassBitMasks
• WwanWCDMABandClass
• WwanLTEBandClass
• WwanNRBandClass
• WwanMiscCaps

Syntax

typedef struct _WWAN_DEVICE_CAPS_EX_REV1 {
  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;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX_REV1, *PWWAN_DEVICE_CAPS_EX_REV1;

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. Miniporttreiber müssen die Mobilfunkklasse auf einen anderen Wert als WwanCellularClassUnknown festlegen. Die Werte in diesem Elementsteuerungsfeatures, die für Mobilfunktechnologie spezifisch sind, z. B. Registrierungsmodi des Netzwerkanbieters.

Miniporttreiber, die Multimodus 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. Der Miniporttreiber bestimmt, wie die Leitungsstimme unterstützt werden soll. Dieses WwanVoiceClass-Mitglied ermöglicht es dem MB-Dienst, dieses Feature in Zukunft zu unterstützen.

WwanSimClass

Die Klasse des Abonnentenidentitätsmoduls (SIM Karte). 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. In der folgenden Tabelle sind die möglichen Werte für dieses Element aufgeführt.

CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]

Eine 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-Member festlegt.

WwanGsmBandClass

Eine Bitmap, die die Frequenzbänder darstellt, die GSM-basierte Geräte unterstützen. In der folgenden Tabelle sind die möglichen Werte für dieses Element aufgeführt.

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 daher 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

Das WwanDeviceType-Element für WWAN_DEVICE_CAPS_EX_REV1 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.

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

WWAN_DEVICE_CAPS_EX

NDIS_WWAN_DEVICE_CAPS

WWAN_CELLULAR_CLASS

WWAN_DEVICE_TYPE

WWAN_SIM_CLASS

WWAN_VOICE_CLASS