WWAN_DEVICE_CAPS-Struktur (wwan.h)

Die WWAN_DEVICE_CAPS-Struktur stellt die Funktionen des MB-Geräts dar.

Syntax

typedef struct _WWAN_DEVICE_CAPS {
  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;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS, *PWWAN_DEVICE_CAPS;

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 Subscriber Identity Module (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. 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 Typ der vom Gerät unterstützten IP-Adresse zu informieren.

DeviceId[WWAN_DEVICEID_LEN]

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

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

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

Für Multimodusfä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 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-beendete Zeichenfolge, die den Hersteller des Geräts darstellt. Dieses Member ist optional.

Model[WWAN_MODEL_LEN]

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

FirmwareInfo[WWAN_FIRMWARE_LEN]

Eine NULL-beendete 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 aktivierungsversuche, die MaxActivatedContexts überschreiten, fehlschlagen.

WwanAuthAlgoCaps

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

CellularClassListHeader

Ein formatiertes WWAN_LIST_HEADER-Objekt, das eine Liste von Mobilfunkklassen darstellt, die ein Multimodusfähiges Gerät unterstützt. 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

Miniporttreiber sollten WWAN_DATA_CLASS_CUSTOM angeben, wenn der vom Gerät unterstützte Datendienst zu keinem der anderen Werte gehört, die in der Tabelle für das WwanDataClass-Element definiert sind. Wenn ein Miniporttreiber das WWAN_DATA_CLASS_CUSTOM-Flag festlegt, sollte der Miniporttreiber auch den Namen der Datenklasse im CustomDataClass-Member 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 für die Vollständigkeit definiert.

Anforderungen

Weitere Informationen

NDIS_WWAN_DEVICE_CAPS

WWAN_CELLULAR_CLASS

WWAN_DEVICE_TYPE

WWAN_SIM_CLASS

WWAN_VOICE_CLASS