MB-Datenmodell
Das MB-Treibermodell verwendet ein Datenmodell, das aus einer Reihe von Objekten besteht, die als Abstraktionen von MB-Gerätefeatures definiert sind. Jedes Objekt wird durch einen eindeutigen Objektbezeichner (OID) identifiziert und durch einen Satz entsprechender Attribute definiert. Der Satz von Attributen ist in einer Datenstruktur organisiert. Um das Gerät zu verwalten, tauschen der MB-Dienst und der MB-Miniporttreiber OIDs und die zugehörigen Datenstrukturen basierend auf OID-Anforderungen und -Angaben aus, die von der Network Driver Interface Specification (NDIS) bereitgestellt werden.
Im MB-Treibermodell werden nur Set - und Abfragevorgänge für OID-Anforderungen verwendet. Das MB-Treibermodell verwendet keine Methodenvorgänge . Für Hinweise verwendet das MB-Treibermodell sowohl Ereignis- als auch Transaktionsbenachrichtigungen, um Zustandsänderungen in den Objekten des MB-Geräts anzuzeigen. Transaktionsbenachrichtigungen signalisieren auch den Abschluss einer asynchronen Transaktion.
In den folgenden Tabellen sind die OIDs und status, die für MB-Miniporttreiber definiert sind, sowie die zugehörigen Datenstrukturen aufgeführt. MB-Miniporttreiber müssen alle obligatorischen allgemeinen OIDs implementieren, die die NDIS 6.20-Spezifikation erfordert. Eine Liste der allgemeinen OIDs für NDIS 6.x finden Sie unter Allgemeine operative OIDs.
Darüber hinaus müssen MB-Miniporttreiber OID_GEN_PHYSICAL_MEDIUM implementieren, obwohl dies in der NDIS-Spezifikation als optional zu implementieren gilt.
Die Syntax und Semantik der mb-OIDs, die in der folgenden Tabelle aufgeführt sind, werden unter MB Operational Semantics beschrieben.
WWAN-Specific OIDs
| OID und entsprechende Datenstruktur | Set, Windows 7 | Festlegen, Windows 8 | Abfrage, Windows 7 | Abfrage, Windows 8 | GSM/CDMA |
|---|---|---|---|---|---|
| OID_WWAN_DRIVER_CAPS verwendet NDIS_WWAN_DRIVER_CAPS | Nicht unterstützt | Nicht unterstützt | E | E | GSM, CDMA |
| OID_WWAN_DEVICE_CAPS verfügt über keine entsprechende Struktur. | Nicht unterstützt | Nicht unterstützt | Ein | A | GSM, CDMA |
| OID_WWAN_READY_INFO verfügt über keine entsprechende Struktur. | Nicht unterstützt Nicht unterstützt | Ein | A | GSM, CDMA | |
| OID_WWAN_SERVICE_ACTIVATION† verwendet NDIS_WWAN_SERVICE_ACTIVATION | Ein | A | Nicht unterstützt | Nicht unterstützt | GSM, CDMA |
| OID_WWAN_RADIO_STATE verwendet NDIS_WWAN_SET_RADIO_STATE | Ein | Ein | Ein | A | GSM, CDMA |
| OID_WWAN_PIN verwendet NDIS_WWAN_SET_PIN | A | Nicht unterstützt | A | Nicht unterstützt | GSM, CDMA |
| OID_WWAN_PIN_LIST verfügt über keine entsprechende Struktur | Nicht unterstützt | Nicht unterstützt | Ein | A | GSM, CDMA |
| OID_WWAN_PIN_EX verwendet NDIS_WWAN_SET_PIN_EX | Nicht unterstützt | A | Nicht unterstützt | A | GSM, CDMA |
| OID_WWAN_HOME_PROVIDER verfügt über keine entsprechende Struktur | Nicht unterstützt | Nicht unterstützt | Ein | A | GSM, CDMA |
| OID_WWAN_PREFERRED_PROVIDERS† verwendet NDIS_WWAN_SET_PREFERRED_PROVIDERS | Ein | Ein | Ein | A | Nur GSM |
| OID_WWAN_VISIBLE_PROVIDERS verfügt über keine entsprechende Struktur | Nicht unterstützt | Nicht unterstützt | Ein | A | GSM |
| OID_WWAN_REGISTER_STATE verwendet NDIS_WWAN_SET_REGISTER_STATE | Ein | Ein | Ein | A | CDMA |
| OID_WWAN_SIGNAL_STATE verwendet NDIS_WWAN_SET_SIGNAL_INDICATION | Ein | Ein | Ein | A | GSM, CDMA |
| OID_WWAN_PACKET_SERVICE verwendet NDIS_WWAN_SET_PACKET_SERVICE | Ein | Ein | Ein | A | GSM, CDMA |
| OID_WWAN_PROVISIONED_CONTEXTS†† verwendet NDIS_WWAN_SET_PROVISIONED_CONTEXT | Ein | Ein | Ein | A | GSM, CDMA |
| OID_WWAN_CONNECT verwendet NDIS_WWAN_SET_CONTEXT_STATE | Ein | Ein | Ein | A | GSM, CDMA |
| OID_WWAN_SMS_CONFIGURATION verwendet NDIS_WWAN_SET_SMS_CONFIGURATION | Ein | Ein | Ein | A | GSM, CDMA |
| OID_WWAN_SMS_READ verwendet NDIS_WWAN_SMS_READ | Nicht unterstützt | Ein | Ein | A | GSM, CDMA |
| OID_WWAN_SMS_SEND verwendet NDIS_WWAN_SMS_SEND | Ein | A | Nicht unterstützt | Nicht unterstützt | GSM, CDMA |
| OID_WWAN_SMS_DELETE verwendet NDIS_WWAN_SMS_DELETE | Ein | A | Nicht unterstützt | Nicht unterstützt | GSM, CDMA |
| OID_WWAN_SMS_STATUS verwendet NDIS_WWAN_SMS_STATUS | Nicht unterstützt | Nicht unterstützt | Ein | A | GSM, CDMA |
| OID_WWAN_VENDOR_SPECIFIC† verwendet eine vom Hersteller definierte Struktur | Ein | A | Nicht unterstützt | Nicht unterstützt | GSM, CDMA |
| OID_WWAN_DEVICE_SERVICES hat keine entsprechende Struktur | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | A | GSM, CDMA |
| OID_WWAN_SUBSCRIBE_DEVICE_SERVICE_EVENTS verwendet NDIS_WWAN_SUBSCRIBE_DEVICE_SERVICE_EVENTS | Nicht unterstützt | A | Nicht unterstützt | Nicht unterstützt | GSM, CDMA |
| OID_WWAN_AUTH_CHALLENGE verwendet NDIS_WWAN_AUTH_CHALLENGE | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | A | GSM, CDMA |
| OID_WWAN_USSD verwendet NDIS_WWAN_USSD_REQUEST | Nicht unterstützt | A | Nicht unterstützt | Nicht unterstützt | GSM |
| OID_WWAN_DEVICE_SERVICE_COMMAND verwendet NDIS_WWAN_DEVICE_SERVICE_COMMAND | Nicht unterstützt | A | Nicht unterstützt | A | GSM, CDMA |
Hinweis
Die folgenden Hinweise gelten für die obige Tabelle: † stellt optionale OIDs dar, die Miniporttreiber möglicherweise unterstützen. Miniporttreiber, die die optionalen OIDs nicht unterstützen, dürfen diese nicht in OID_GEN_SUPPORTED_LIST zurückgeben.
†† stellt Miniporttreiber dar, die GSM-basierte Geräte unterstützen, die optional OID_WWAN_PROVISIONED_CONTEXTS Set- und Abfragevorgänge unterstützen können. Miniporttreiber, die CDMA-basierte Geräte unterstützen, können optional OID_WWAN_PROVISIONED_CONTEXTS Abfragevorgänge für CDMA-basierte Geräte unterstützen, die simple IP (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP) melden.
Miniporttreiber müssen alle nicht optionalen OIDs unterstützen. Der MB-Dienst kann jeden Miniporttreiber ignorieren, der nicht alle obligatorischen OIDs meldet.
"A" und "S" in den Spalten "Set" und "Query" in der vorherigen Tabelle spiegeln die Art der Transaktion zum Abschließen der OID-Anforderung wider: "A" steht für eine asynchrone Transaktion und "S" für eine synchrone Transaktion.
Die Datenstrukturen in der vorherigen Tabelle entsprechen dem Festlegen von Vorgangs-OIDs und der Rückgabe von Daten für synchrone Abfragevorgangs-OIDs.
Die folgenden OIDs verwenden eine gemeinsame Datenstruktur mit variabler Länge namens WWAN_LIST_HEADER in ihren entsprechenden Datenstrukturen:
- OID_WWAN_READY_INFO
- OID_WWAN_PREFERRED_PROVIDERS
- OID_WWAN_VISIBLE_PROVIDERS
- OID_WWAN_PROVISIONED_CONTEXTS
- OID_WWAN_SMS_READ
WWAN-Specific Indikationen, entsprechende Datenstrukturen und Betriebssystemrevisionen
Anzeige und entsprechende Datenstruktur |
Windows 7-Revision Windows 8 Revision |
|
verwendet NDIS_WWAN_DEVICE_CAPS |
NDIS_WWAN_DEVICE_CAPS_REVISION_1 NDIS_WWAN_DEVICE_CAPS_REVISION_2 |
|
verwendet NDIS_WWAN_READY_INFO |
NDIS_WWAN_READY_INFO_REVISION_1 NDIS_WWAN_READY_INFO_REVISION_1 |
|
verwendet NDIS_WWAN_RADIO_STATE |
NDIS_WWAN_RADIO_STATE_REVISION_1 NDIS_WWAN_RADIO_STATE_REVISION_1 |
|
verwendet NDIS_WWAN_PIN_INFO |
NDIS_WWAN_PIN_INFO_REVISION_1 NDIS_WWAN_PIN_INFO_REVISION_1 |
|
verwendet NDIS_WWAN_PIN_LIST |
NDIS_WWAN_PIN_LIST_REVISION_1 NDIS_WWAN_PIN_LIST_REVISION_1 |
NDIS_STATUS_WWAN_SERVICE_ACTIVATION† verwendet NDIS_WWAN_SERVICE_ACTIVATION_STATUS |
NDIS_WWAN_SERVICE_ACTIVATION_STATUS_REVISION_1 NDIS_WWAN_SERVICE_ACTIVATION_STATUS_REVISION_1 |
NDIS_STATUS_WWAN_HOME_PROVIDER verwendet NDIS_WWAN_HOME_PROVIDER |
NDIS_WWAN_HOME_PROVIDER_REVISION_1 NDIS_WWAN_HOME_PROVIDER_REVISION_1 |
NDIS_STATUS_WWAN_PREFERRED_PROVIDERS† verwendet NDIS_WWAN_PREFERRED_PROVIDERS |
NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1 NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1 |
NDIS_STATUS_WWAN_VISIBLE_PROVIDERS verwendet NDIS_WWAN_VISIBLE_PROVIDERS |
NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1 NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1 |
NDIS_STATUS_WWAN_REGISTER_STATE verwendet NDIS_WWAN_REGISTRATION_STATE |
NDIS_WWAN_REGISTRATION_STATE_REVISION_1 NDIS_WWAN_REGISTRATION_STATE_REVISION_2 |
|
verwendet NDIS_WWAN_SIGNAL_STATE |
NDIS_WWAN_SIGNAL_STATE_REVISION_1 NDIS_WWAN_SIGNAL_STATE_REVISION_1 |
NDIS_STATUS_WWAN_PACKET_SERVICE verwendet NDIS_WWAN_PACKET_SERVICE_STATE |
NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1 NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1 |
NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS verwendet NDIS_WWAN_PROVISIONED_CONTEXTS |
NDIS_WWAN_PROVISIONED_CONTEXTS_REVISION_1 NDIS_WWAN_PROVISIONED_CONTEXTS_REVISION_1 |
NDIS_STATUS_WWAN_CONTEXT_STATE verwendet NDIS_WWAN_CONTEXT_STATE |
NDIS_WWAN_CONTEXT_STATE_REVISION_1 NDIS_WWAN_CONTEXT_STATE_REVISION_1 |
NDIS_STATUS_WWAN_SMS_CONFIGURATION verwendet NDIS_WWAN_SMS_CONFIGURATION |
NDIS_WWAN_SMS_CONFIGURATION_REVISION_1 NDIS_WWAN_SMS_CONFIGURATION_REVISION_1 |
|
verwendet NDIS_WWAN_SMS_RECEIVE |
NDIS_WWAN_SMS_RECEIVE_REVISION_1 NDIS_WWAN_SMS_RECEIVE_REVISION_1 |
|
verwendet NDIS_WWAN_SMS_SEND_STATUS |
NDIS_WWAN_SMS_SEND_STATUS_REVISION_1 NDIS_WWAN_SMS_SEND_STATUS_REVISION_1 |
|
verwendet NDIS_WWAN_SMS_DELETE_STATUS |
NDIS_WWAN_SMS_DELETE_STATUS_REVISION_1 NDIS_WWAN_SMS_DELETE_STATUS_REVISION_1 |
|
verwendet NDIS_WWAN_SMS_STATUS |
NDIS_WWAN_SMS_STATUS_REVISION_1 NDIS_WWAN_SMS_STATUS_REVISION_1 |
NDIS_STATUS_WWAN_VENDOR_SPECIFIC† verwendet eine vom Anbieter definierte Struktur |
– |
|
verwendet NDIS_WWAN_USSD_EVENT |
NDIS_WWAN_USSD_EVENT_REVISION_1 NDIS_WWAN_USSD_EVENT_REVISION_1 |
NDIS_WWAN_DEVICE_SERVICES_REVISION_1 NDIS_WWAN_DEVICE_SERVICES_REVISION_1 |
|
NDIS_STATUS_WWAN_DEVICE_SERVICE_RESPONSE verwendet NDIS_WWAN_DEVICE_SERVICE_RESPONSE |
NDIS_WWAN_DEVICE_SERVICE_RESPONSE_REVISION_1 NDIS_WWAN_DEVICE_SERVICE_RESPONSE_REVISION_1 |
NDIS_STATUS_WWAN_DEVICE_SERVICE_EVENT verwendet NDIS_WWAN_DEVICE_SERVICE_EVENT |
NDIS_WWAN_DEVICE_SERVICE_EVENT_REVISION_1 NDIS_WWAN_DEVICE_SERVICE_EVENT_REVISION_1 |
NDIS_STATUS_WWAN_DEVICE_SERVICE_SUBSCRIPTION verwendet NDIS_WWAN_DEVICE_SERVICE_SUBSCRIPTION |
NDIS_WWAN_DEVICE_SERVICE_SUBSCRIPTION_REVISION_1 NDIS_WWAN_DEVICE_SERVICE_SUBSCRIPTION_REVISION_1 |
NDIS_STATUS_WWAN_AUTH_RESPONSE verwendet NDIS_WWAN_AUTH_RESPONSE |
NDIS_WWAN_AUTH_RESPONSE_REVISION_1 NDIS_WWAN_AUTH_RESPONSE_REVISION_1 |
NDIS_STATUS_WWAN_SET_HOME_PROVIDER_COMPLETE verwendet NDIS_WWAN_SET_HOME_PROVIDER |
– NDIS_WWAN_HOME_PROVIDER_REVISION_2 |
Hinweis
Die folgenden Hinweise gelten für die obige Tabelle: † stellt optionale Hinweise dar, die Miniporttreiber möglicherweise unterstützen. Beachten Sie, dass der Miniporttreiber auch die entsprechende Anzeige unterstützen sollte, wenn ein Miniporttreiber eine optionale OID unterstützt.
WWAN-Specific Indikationsunterstützung für GSM-, CDMA- und unaufgefragte Indikationen
Anzeige |
GSM |
CDMA |
Unerwünschte Angabe Erlaubt? |
X |
X |
N |
|
X |
X |
J |
|
X |
X |
J |
|
X |
X |
N |
|
X |
X |
N |
|
X |
X |
N |
|
X |
X |
N |
|
X |
J |
||
X |
X |
N |
|
X |
X |
J |
|
X |
X |
J |
|
NDIS_STATUS_WWAN_PACKET_SERVICE verwendet NDIS_WWAN_PACKET_SERVICE_STATE |
X |
X |
J |
X |
X |
J |
|
X |
X |
J |
|
X |
X |
J |
|
X |
X |
J |
|
|
verwendet NDIS_WWAN_SMS_SEND_STATUS |
X |
X |
N |
X |
X |
N |
|
X |
X |
J |
|
X |
X |
J |
|
X |
J |
||
X |
X |
N |
|
X |
X |
N |
|
X |
X |
J |
|
X |
X |
N |
|
X |
X |
N |
|
X |
X |
N |
Multi-Carrier-spezifische OIDs
Die folgenden Änderungen gelten für NDIS 6.30-Miniporttreiber, die den Multi-Carrier-Modus unterstützen. Wenn der Miniporttreiber den Multi-Carrier-Modus nicht unterstützt, lesen Sie die obige Tabelle.
OID und Windows 8 entsprechende Datenstruktur |
Abfragevorgang |
Vorgang festlegen |
GSM/CDMA |
|
verwendet NDIS_WWAN_SET_HOME_PROVIDER |
Ein |
A |
GSM, CDMA |
OID_WWAN_PREFERRED_MULTICARRIER_PROVIDERS verwendet NDIS_WWAN_SET_PREFERRED_MULTICARRIER_PROVIDERS. PreferredListHeader.ElementType sollte auf WwanStructProvider2 festgelegt werden, und die Struktur ist WWAN_PROVIDER2. |
Ein |
A |
GSM, CDMA |
Spezifische Indikationen mit mehreren Trägern, entsprechende Datenstrukturen und Betriebssystemrevisionen
Anzeige und entsprechende Datenstruktur |
Windows 8 Revision |
NDIS_STATUS_WWAN_HOME_PROVIDER verwendet NDIS_WWAN_HOME_PROVIDER2 |
NDIS_WWAN_HOME_PROVIDER_REVISION_2 |
NDIS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS_REVISION_1. Der PreferredListHeader.ElementType sollte auf WwanStructProvider2 festgelegt werden, und die Liste sollte WWAN_PROVIDER2 Struktur enthalten. |
|
NDIS_STATUS_WWAN_VISIBLE_PROVIDERS verwendet NDIS_WWAN_VISIBLE_PROVIDERS |
NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1. VisibleListHeader.ElementType sollte auf WwanStructProvider2 festgelegt werden, und die Liste sollte WWAN_PROVIDER2 Struktur enthalten. |
Unterstützung für spezifische Indikationen mit mehreren Trägern für GSM, CDMA und unaufgefragte Indikationen
Anzeige und entsprechende Datenstruktur |
GSM |
CDMA |
Unerwünschte Angabe Erlaubt? |
X |
X |
N |
|
X |
X |
J |
|
NDIS_STATUS_WWAN_VISIBLE_PROVIDERS verwendet NDIS_WWAN_VISIBLE_PROVIDERS |
X |
X |
N |