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.
| Wert | Bedeutung |
|---|---|
| WWAN_DATA_CLASS_NONE | Das Gerät unterstützt keinen Datendienst. |
| WWAN_DATA_CLASS_GPRS | Der GPRS-Datendienst (General Packet Radio Service) wird unterstützt. Dieser Wert gilt nur für GSM-basierte Geräte. |
| WWAN_DATA_CLASS_EDGE | Der Edge-Datendienst (Enhanced Data for Global Evolution) wird unterstützt. Dieser Wert gilt nur für GSM-basierte Geräte. |
| WWAN_DATA_CLASS_UMTS | Der UMTS-Datendienst (Universal Mobile Telecommunications System) wird unterstützt. Dieser Wert gilt nur für GSM-basierte Geräte. |
| WWAN_DATA_CLASS_HSDPA | High-Speed HSDPA-Datendienst (Downlink Packet Access) wird unterstützt. Dieser Wert gilt nur für GSM-basierte Geräte. |
| WWAN_DATA_CLASS_HSUPA | High-Speed HsUPA-Datendienst (Uplink Packet Access) wird unterstützt. Dieser Wert gilt nur für GSM-basierte Geräte. |
| WWAN_DATA_CLASS_LTE | DER LTE-Datendienst wird unterstützt. Dieser Wert gilt nur für GSM-basierte Geräte. |
| WWAN_DATA_CLASS_5G | Der 5G-Datendienst wird unterstützt. |
| WWAN_DATA_CLASS_TDSCDMA | Time Division Synchronous CDMA-Datendienst wird unterstützt. |
| WWAN_DATA_CLASS_1XRTT | Der Datendienst CDMA 1x Radio Transmission Technology (1xRTT, auch bekannt als cdma2000, CDMA2000 1x usw.) wird unterstützt. Dieser Wert gilt nur für CDMA-basierte Geräte. |
| WWAN_DATA_CLASS_1XEVDO | CDMA Evolution-Data Optimierter Datendienst (ursprünglich Nur Daten, 1xEDVO, auch bekannt als CDMA2000 1x EV-DO oder 1x EVDO) wird unterstützt. Dieser Wert gilt nur für CDMA-basierte Geräte. |
| WWAN_DATA_CLASS_1XEVDO_REVA | Der 1xEVDO RevA-Datendienst wird unterstützt. Dieser Wert gilt nur für CDMA-basierte Geräte. |
| WWAN_DATA_CLASS_1XEVDV | Der CDMA Evolution Data/Voice-Datendienst (auch bekannt als CDMA 2000 1x EV-DV oder 1x EVDV) wird unterstützt. Dieser Wert gilt nur für CDMA-basierte Geräte. |
| WWAN_DATA_CLASS_3XRTT | CDMA 3x Radio Transmission Technology (3xRTT) Datendienst wird unterstützt. Dieser Wert gilt nur für CDMA-basierte Geräte. |
| WWAN_DATA_CLASS_1XEVDO_REVB | Der 1xEVDO RevB-Datendienst wird unterstützt. Dieser Wert gilt nur für CDMA-basierte Geräte. |
| WWAN_DATA_CLASS_UMB | DER UMB-Datendienst wird unterstützt. Dieser Wert gilt nur für CDMA-basierte Geräte. |
| WWAN_DATA_CLASS_CUSTOM | Das Gerät unterstützt einen Datendienst, der nicht in dieser Tabelle aufgeführt ist. |
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.
| Wert | Bedeutung |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | Das vom Gerät unterstützte Frequenzband wird nicht angegeben. |
| WWAN_BAND_CLASS_I | Das Gerät unterstützt das UMTS2100 Spektrum. |
| WWAN_BAND_CLASS_II | Das Gerät unterstützt das UMTS1900 Spektrum. |
| WWAN_BAND_CLASS_III | Das Gerät unterstützt das UMTS1800 Spektrum. |
| WWAN_BAND_CLASS_IV | Das Gerät unterstützt das AWS-Spektrum. |
| WWAN_BAND_CLASS_V | Das Gerät unterstützt das UMTS850 Spektrum. |
| WWAN_BAND_CLASS_VI | Das Gerät unterstützt das UMTS800 Spektrum. |
| WWAN_BAND_CLASS_VII | Das Gerät unterstützt das UMTS2600 Spektrum. |
| WWAN_BAND_CLASS_VIII | Das Gerät unterstützt das UMTS900 Spektrum. |
| WWAN_BAND_CLASS_IX | Das Gerät unterstützt das UMTS1700 Spektrum. |
| WWAN_BAND_CLASS_X | |
| WWAN_BAND_CLASS_CUSTOM | Das Gerät unterstützt ein anderes Spektrum als die in dieser Tabelle aufgeführten. |
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.
| Wert | Bedeutung |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | Das vom Gerät unterstützte Frequenzband wird nicht angegeben. |
| WWAN_BAND_CLASS_0 | Das Gerät unterstützt das 800MHz-Band. |
| WWAN_BAND_CLASS_I | Das Gerät unterstützt das 1900MHz-Band. |
| WWAN_BAND_CLASS_II | Das Gerät unterstützt das TACS-Band. |
| WWAN_BAND_CLASS_III | Das Gerät unterstützt das JTACS-Band. |
| WWAN_BAND_CLASS_IV | Das Gerät unterstützt das koreanische PCS-Band. |
| WWAN_BAND_CLASS_V | Das Gerät unterstützt das 450-MHz-Band. |
| WWAN_BAND_CLASS_VI | Das Gerät unterstützt das 2-GHz-Band. |
| WWAN_BAND_CLASS_VII | Das Gerät unterstützt das 700-MHz-Band. |
| WWAN_BAND_CLASS_VIII | Das Gerät unterstützt das 1800-MHz-Band. |
| WWAN_BAND_CLASS_IX | Das Gerät unterstützt das 900-MHz-Band. |
| WWAN_BAND_CLASS_X | Das Gerät unterstützt das sekundäre 800-MHz-Band. |
| WWAN_BAND_CLASS_XI | Das Gerät unterstützt das europäische PAMR-Band mit 400 MHz. |
| WWAN_BAND_CLASS_XII | Das Gerät unterstützt das PAMR-Band mit 800 MHz. |
| WWAN_BAND_CLASS_XIII | Das Gerät unterstützt das 2,5-GHz-IMT2000-Erweiterungsband. |
| WWAN_BAND_CLASS_XIV | Das Gerät unterstützt das US-PCS-Band mit 1,9 GHz. |
| WWAN_BAND_CLASS_XV | Das Gerät unterstützt das AWS-Band. |
| WWAN_BAND_CLASS_XVI | Das Gerät unterstützt das US-Band mit 2,5 GHz. |
| WWAN_BAND_CLASS_XVII | Das Gerät unterstützt das Us-Amerikanische Forward Link Only-Band mit 2,5 GHz. |
| WWAN_BAND_CLASS_CUSTOM | Das Gerät unterstützt ein anderes Band als die in dieser Tabelle aufgeführten Bänder. |
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.
| Wert | Bedeutung |
|---|---|
| WWAN_SMS_CAPS_NONE | Das Gerät unterstützt keine SMS-Nachrichten. |
| WWAN_SMS_CAPS_PDU_SEND |
Für GSM-basierte Geräte bedeutet dieser Wert, dass das Gerät das Senden von SMS-Nachrichten im PDU-Stil unterstützt.
Für CDMA-basierte Geräte bedeutet dieser Wert, dass das Gerät in der Lage ist, SMS-Nachrichten im Binärformat zu senden, wie im Abschnitt "3.4.2.1 SMS Point-to-Point Message" in 3GPP2-Spezifikation C.S0015-A "Short Message Service (SMS) for Wideband Spread Spectrum Systems" definiert. |
| WWAN_SMS_CAPS_PDU_RECEIVE |
Für GSM-basierte Geräte bedeutet dieser Wert, dass das Gerät den Empfang von SMS-Nachrichten im PDU-Stil unterstützt.
Für CDMA-basierte Geräte bedeutet dieser Wert, dass das Gerät die SMS-Nachrichten im Binärformat lesen kann, wie im Abschnitt "3.4.2.1 SMS Point-to-Point Message" in der 3GPP2-Spezifikation C.S0015-A "Short Message Service (SMS) for Wideband Spread Spectrum Systems" definiert. |
| WWAN_SMS_CAPS_TEXT_SEND | Das Gerät unterstützt das Senden von SMS-Nachrichten im Textstil. Dieses Flag gilt für CDMA-basierte Geräte. |
| WWAN_SMS_CAPS_TEXT_RECEIVE | Das Gerät unterstützt den Empfang von SMS-Nachrichten im Textstil. Dieses Flag gilt für CDMA-basierte Geräte. |
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.
| Wert | Bedeutung |
|---|---|
| WWAN_CTRL_CAPS_REG_MANUAL | Gibt an, ob das Anbieternetzwerk die manuelle Netzwerkauswahl zulässt. Miniporttreiber für GSM-basierte Geräte sollten dieses Flag angeben. Miniporttreiber für CDMA-basierte Geräte sollten dieses Flag nicht angeben. |
| WWAN_CTRL_CAPS_HW_RADIO_SWITCH | Gibt an, dass ein Hardware-Funkschalter vorhanden ist. Dies entspricht dem WwanDeviceTypeEmbedded-Wert der WWAN_DEVICE_TYPE-Enumeration. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP |
Gibt an, dass das CDMA-basierte Gerät für die Unterstützung mobiler IP-Adressen konfiguriert ist. Dieses Flag gilt nur für CDMA-basierte Geräte.
Miniport-Treiber sollten dieses Flag nicht festlegen, wenn der aktuelle Home-Anbieter multimodusfähig ist. |
| WWAN_CTRL_CAPS_CDMA_SIMPLE_IP |
Gibt an, dass das CDMA-basierte Gerät für die einfache IP-Unterstützung konfiguriert ist. Dieses Flag gilt nur für CDMA-basierte Geräte.
Miniport-Treiber sollten dieses Flag nicht festlegen, wenn der aktuelle Home-Anbieter multimodusfähig ist. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP mit WWAN_CTRL_CAPS_CDMA_SIMPLE_IP | Gibt an, dass das CDMA-basierte Gerät für die Unterstützung mobiler IP-Adressen mit einfacher IP-Adresse als Fallbackoption konfiguriert ist. |
| WWAN_CTRL_CAPS_PROTECT_UNIQUEID | Gibt an, dass Windows die International Mobile Subscriber Identity (IMSI) nicht anzeigen sollte. |
| WWAN_CTRL_CAPS_USSD |
Gibt an, dass das GSM-basierte MB-Gerät für die Unterstützung des USSD-Protokolls konfiguriert ist. Dieses Flag gilt nur für GSM-basierte Geräte.
Miniport-Treiber, die das Senden und Empfangen von USSD-Nachrichten unterstützen, legen dieses Flag fest. Miniport-Treiber können dieses Flag festlegen, wenn die aktuellen Multimodus-fähigen Heimanbieter, die GSM-Seite des Netzwerks, USSD unterstützt, auch wenn die CDMA-Seite des Netzwerks USSD nicht unterstützt. |
| WWAN_CTRL_CAPS_MODEL_MULTI_CARRIER | Gibt an, dass das MB-Gerät die Registrierung und Verbindung mit mehreren Netzbetreibern unterstützt. |
| WWAN_CTRL_CAPS_MULTI_MODE | Dieses Flag gibt an, dass der aktuelle Heimanbieter mehrere Mobilfunkklassen/RATs (Radio Access Technologies) unterstützt. |
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.
| Wert | Bedeutung |
|---|---|
| WWAN_AUTH_ALGO_CAPS_NONE | Das MB-Gerät unterstützt keine Authentifizierungsmethoden. |
| WWAN_AUTH_ALGO_CAPS_SIM | Das MB-Gerät unterstützt die SIM-Authentifizierungsmethode. |
| WWAN_AUTH_ALGO_CAPS_AKA | Das MB-Gerät unterstützt die AKA-Authentifizierungsmethode. |
| WWAN_AUTH_ALGO_CAPS_AKAP | Das MB-Gerät unterstützt die AKA-Authentifizierungsmethode (AKA Prime). |
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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 8 und höheren Versionen von Windows. |
| Kopfzeile | wwan.h (include Wwan.h) |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für