MB-SMS-Vorgänge

In diesem Thema werden die Vorgänge zum Konfigurieren, Lesen/Empfangen, Senden und Löschen von Nachrichten mithilfe der SMS-Funktionen (Short Message Service) eines MB-Geräts beschrieben.

SMS-Unterstützung ist obligatorisch. Miniporttreiber müssen die entsprechenden Sende- und Empfangs-SMS-Funktionsflags festlegen, die sie beim Verarbeiten OID_WWAN_DEVICE_CAPS Abfrageanforderungen im WwanSmsCaps-Member der WWAN_DEVICE_CAPS-Struktur unterstützen. Wenn Miniporttreiber sms nicht unterstützen, sollten sie WWAN_SMS_CAPS_NONE angeben und WWAN_STATUS_SMS_UNKNOWN_ERROR für alle SMS-bezogenen OIDs zurückgeben.

Miniporttreiber sollten nur SMS-Vorgänge verarbeiten , nachdem OID_WWAN_READY_INFOWwanReadyStateInitialize als gerätebereiten Zustand zurückgibt. Miniport-Treiber sollten einige SMS-Vorgänge, z. B. das Senden einer SMS-Nachricht, erst verarbeiten, nachdem das Gerät in einem Anbieternetzwerk registriert wurde (obwohl nicht unbedingt die Datendienstregistrierung erforderlich ist).

Der MB-Dienst unterscheidet nicht zwischen verschiedenen Nachrichtenspeichern, die auf dem Gerät verfügbar sind. Daher müssen Miniporttreiber alle Nachrichtenspeicher verarbeiten und einen einzelnen virtuellen Nachrichtenspeicher projizieren, auf den über einen virtuellen Index zugegriffen wird. Wenn das Gerät beispielsweise über drei Nachrichtenspeicher verfügt, muss der Miniporttreiber alle zusammen verarbeiten und sie als einzelnen Nachrichtenspeicher für den Dienst darstellen.

Das MB-Treibermodell unterstützt die folgenden SMS-Vorgänge:

• SMS-Konfiguration

• SMS lesen

• Senden einer SMS

• SMS löschen

Miniporttreiber empfehlen, SMS-Konfigurations-, Lese-, Sende- und Löschvorgänge zu unterstützen und den Benutzer über neue SMS-Nachrichten zu benachrichtigen, die von einem Gerät empfangen werden.

Weitere Informationen zu SMS-Vorgängen finden Sie unter OID_WWAN_SMS_CONFIGURATION, OID_WWAN_SMS_READ, OID_WWAN_SMS_SEND, OID_WWAN_SMS_DELETE und OID_WWAN_SMS_STATUS.

Relevante Dienste und Treiber

SmsRouterSvc.dll : Der Dienst, der mit WwanSvc interagiert, um das Senden und Empfangen von Bildern zu verarbeiten

MbSmsApi.dll – Implementierung der WinRT-SMS-API

UT_SmsRouter.dll – Integriert in reale Gerätetests

SMS-Architektur/-Flows

SMS-Blockdiagramm

SMS App-Registrierung

Senden einer SMS

API-Nachricht empfangen

App-Lebenszyklus

Dienstlebenszyklus

Testen

Automatisierte SMS-Tests

Die folgenden Tests werden automatisiert und in ri-TP integriert. Sie werden täglich ausgeführt und sollten 100 % bestehen.

• MobilebroadbandExperience\SmsApi

• MobilebroadbandExperience\SMSCDMA

• MobilebroadbandExperience\SMSDecodingTests

• MobilebroadbandExperience\SMSEncodingTests

• WWAN\SMS\Service\UnitTests

SmsApi Tests haben verschiedene Versionen, die auf desktop und onecoreuap ausgeführt werden. Desktop verwendet weiterhin vnelib.dll (C++-Version), da der CDMA-Teil von SMS nicht auf vnelibrary.dll (C#-Version) portiert ist. Daher finden Sie zwei Versionen von Funktionstestlisten.

HlK-Tests (Hardware Lab Kit)

Dies sind alle derzeit verfügbaren HLK-Tests im Zusammenhang mit MB-SMS:

• TestSms

  • CDMA, GSM

• TestSmsStoreFull

  • CDMA, GSM

• TestWake

  • CDMA: IncomingDataPacket, RegisterStateChange
  • GSM: IncomingDataPacket, RegisterStateChange

• TestSimBad

  • GSM

• TestDeviceCapsEx

  • CDMA
  • GSM

• TestSIMNotInserted

  • GSM

Tests werden ausgeführt

Über netsh können Sie die Testlisten und HLK-Tests ausführen. Weitere Informationen zur Verwendung des netsh-Tools finden Sie unter netsh mbn und netsh mbn test installation.

netsh mbn test feature=sms testpath="C:\data\test\bin" taefpath="C:\data\test\bin" param="AccessString=internet"

Protokolle können mithilfe der folgenden Anweisungen gesammelt und decodiert werden: MB-Sammlungsprotokolle.

Spezielle Nachrichten

Operatormeldungen

Operatoren können Geräte bereitstellen, um bestimmte Nachrichten früher zu verarbeiten. Dies ist nicht mehr verfügbar, aber das Feature wurde noch nicht vollständig entfernt. Der Code ProvisioningEngine verarbeitet die Operatorbenachrichtigungen. Weitere Informationen finden Sie unter Operatorbenachrichtigungen und Operatorereignisse.

Broadcast-Nachrichten

Weitere Informationen zu Notfallwarnungen per SMS finden Sie unter SmsBroadcastMessage und SmsBroadcastType.

UWP-Funktionen für SMS

Legacy-SMS-API

Es gibt zwei Legacy-SMS-APIs, sms und smsSend.

Neueste SMS-API

• cellularMessaging

Weitere Informationen finden Sie unter UWP SMS.

Weitere relevante Links

• Entwickeln von SMS-Apps