MB 数据模型

MB 驱动程序模型使用由一组定义为 MB 设备功能抽象的对象组成的数据模型。 每个对象由 OID) (唯一对象标识符标识,并由一组相应的属性定义。 特性集组织到数据结构中。 若要管理设备,MB 服务和 MB 微型端口驱动程序根据网络驱动程序接口规范 (NDIS) 提供的 OID 请求和指示交换 OID 及其关联的数据结构。

在 MB 驱动程序模型中,仅 设置查询 操作用于 OID 请求。 MB 驱动程序模型不使用 方法 操作。 对于指示,MB 驱动程序模型使用事件和事务通知来指示 MB 设备的对象中的状态更改。 事务通知还指示异步事务完成。

下表列出了为 MB 微型端口驱动程序定义的 OID 和状态指示,以及关联的数据结构。 MB 微型端口驱动程序必须实现 NDIS 6.20 规范所需的所有必需的常规 OID。 有关 NDIS 6.x 的常规 OID 列表,请参阅 常规操作 OID

此外,MB 微型端口驱动程序必须实现OID_GEN_PHYSICAL_MEDIUM即使 NDIS 规范将其描述为可选实现也是如此。

MB 操作语义中介绍了下表中列出的 MB OID 的语法和 语义

WWAN-Specific OID

OID 和相应的数据结构 设置,Windows 7 Set、Windows 8 查询,Windows 7 查询,Windows 8 GSM/CDMA
OID_WWAN_DRIVER_CAPS 使用 NDIS_WWAN_DRIVER_CAPS 不支持 不支持 S S GSM、CDMA
OID_WWAN_DEVICE_CAPS 没有相应的结构 不支持 不支持 A A GSM、CDMA
OID_WWAN_READY_INFO 没有相应的结构 不支持 不支持 A A GSM、CDMA
OID_WWAN_SERVICE_ACTIVATION†使用 NDIS_WWAN_SERVICE_ACTIVATION A A 不支持 不支持 GSM、CDMA
OID_WWAN_RADIO_STATE 使用 NDIS_WWAN_SET_RADIO_STATE A A A A GSM、CDMA
OID_WWAN_PIN 使用 NDIS_WWAN_SET_PIN A 不支持 A 不支持 GSM、CDMA
OID_WWAN_PIN_LIST 没有相应的结构 不支持 不支持 A A GSM、CDMA
OID_WWAN_PIN_EX 使用 NDIS_WWAN_SET_PIN_EX 不支持 A 不支持 A GSM、CDMA
OID_WWAN_HOME_PROVIDER 没有相应的结构 不支持 不支持 A A GSM、CDMA
OID_WWAN_PREFERRED_PROVIDERS†使用 NDIS_WWAN_SET_PREFERRED_PROVIDERS A A A A 仅限 GSM
OID_WWAN_VISIBLE_PROVIDERS 没有相应的结构 不支持 不支持 A A GSM
OID_WWAN_REGISTER_STATE 使用 NDIS_WWAN_SET_REGISTER_STATE A A A A CDMA
OID_WWAN_SIGNAL_STATE 使用 NDIS_WWAN_SET_SIGNAL_INDICATION A A A A GSM、CDMA
OID_WWAN_PACKET_SERVICE 使用 NDIS_WWAN_SET_PACKET_SERVICE A A A A GSM、CDMA
OID_WWAN_PROVISIONED_CONTEXTS††使用 NDIS_WWAN_SET_PROVISIONED_CONTEXT A A A A GSM、CDMA
OID_WWAN_CONNECT 使用 NDIS_WWAN_SET_CONTEXT_STATE A A A A GSM、CDMA
OID_WWAN_SMS_CONFIGURATION 使用 NDIS_WWAN_SET_SMS_CONFIGURATION A A A A GSM、CDMA
OID_WWAN_SMS_READ 使用 NDIS_WWAN_SMS_READ 不支持 A A A GSM、CDMA
OID_WWAN_SMS_SEND 使用 NDIS_WWAN_SMS_SEND A A 不支持 不支持 GSM、CDMA
OID_WWAN_SMS_DELETE 使用 NDIS_WWAN_SMS_DELETE A A 不支持 不支持 GSM、CDMA
OID_WWAN_SMS_STATUS 使用 NDIS_WWAN_SMS_STATUS 不支持 不支持 A A GSM、CDMA
OID_WWAN_VENDOR_SPECIFIC†使用供应商定义的结构 A A 不支持 不支持 GSM、CDMA
OID_WWAN_DEVICE_SERVICES 没有相应的结构 不支持 不支持 不支持 A GSM、CDMA
OID_WWAN_SUBSCRIBE_DEVICE_SERVICE_EVENTS 使用 NDIS_WWAN_SUBSCRIBE_DEVICE_SERVICE_EVENTS 不支持 A 不支持 不支持 GSM、CDMA
OID_WWAN_AUTH_CHALLENGE 使用 NDIS_WWAN_AUTH_CHALLENGE 不支持 不支持 不支持 A GSM、CDMA
OID_WWAN_USSD 使用 NDIS_WWAN_USSD_REQUEST 不支持 A 不支持 不支持 GSM
OID_WWAN_DEVICE_SERVICE_COMMAND 使用 NDIS_WWAN_DEVICE_SERVICE_COMMAND 不支持 A 不支持 A GSM、CDMA

注意

以下说明适用于上表:†表示微型端口驱动程序可能支持的可选 OID。 不支持可选 OID 的微型端口驱动程序不得在OID_GEN_SUPPORTED_LIST中返回它们。

††表示支持基于 GSM 的设备的微型端口驱动程序,这些设备可以选择性地支持OID_WWAN_PROVISIONED_CONTEXTS设置和查询操作。 支持基于 CDMA 的设备的微型端口驱动程序可以选择性地支持对报告简单 IP (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP) 的基于 CDMA 的设备执行OID_WWAN_PROVISIONED_CONTEXTS查询操作。

微型端口驱动程序必须支持所有非可选 OID。 MB 服务可能会忽略未报告所有必需 OID 的任何微型端口驱动程序。

上表中“设置”和“查询”操作列中的“A”和“S”反映了完成 OID 请求的事务性质:“A”表示异步事务,“S”表示同步事务。

上表中的数据结构对应于设置操作 OID 并返回同步查询操作 OID 的数据。

以下 OID 在其相应的数据结构中共享名为 WWAN_LIST_HEADER 的通用可变长度列表数据结构:

  • OID_WWAN_READY_INFO
  • OID_WWAN_PREFERRED_PROVIDERS
  • OID_WWAN_VISIBLE_PROVIDERS
  • OID_WWAN_PROVISIONED_CONTEXTS
  • OID_WWAN_SMS_READ

WWAN-Specific指示、相应的数据结构和 OS 修订

指示相应的数据结构

Windows 7 修订版

Windows 8 修订版

NDIS_STATUS_WWAN_DEVICE_CAPS

使用 NDIS_WWAN_DEVICE_CAPS

NDIS_WWAN_DEVICE_CAPS_REVISION_1

NDIS_WWAN_DEVICE_CAPS_REVISION_2

NDIS_STATUS_WWAN_READY_INFO

使用 NDIS_WWAN_READY_INFO

NDIS_WWAN_READY_INFO_REVISION_1

NDIS_WWAN_READY_INFO_REVISION_1

NDIS_STATUS_WWAN_RADIO_STATE

使用 NDIS_WWAN_RADIO_STATE

NDIS_WWAN_RADIO_STATE_REVISION_1

NDIS_WWAN_RADIO_STATE_REVISION_1

NDIS_STATUS_WWAN_PIN_INFO

使用 NDIS_WWAN_PIN_INFO

NDIS_WWAN_PIN_INFO_REVISION_1

NDIS_WWAN_PIN_INFO_REVISION_1

NDIS_STATUS_WWAN_PIN_LIST

使用 NDIS_WWAN_PIN_LIST

NDIS_WWAN_PIN_LIST_REVISION_1

NDIS_WWAN_PIN_LIST_REVISION_1

NDIS_STATUS_WWAN_SERVICE_ACTIVATION

使用 NDIS_WWAN_SERVICE_ACTIVATION_STATUS

NDIS_WWAN_SERVICE_ACTIVATION_STATUS_REVISION_1

NDIS_WWAN_SERVICE_ACTIVATION_STATUS_REVISION_1

NDIS_STATUS_WWAN_HOME_PROVIDER

使用 NDIS_WWAN_HOME_PROVIDER

NDIS_WWAN_HOME_PROVIDER_REVISION_1

NDIS_WWAN_HOME_PROVIDER_REVISION_1

NDIS_STATUS_WWAN_PREFERRED_PROVIDERS

使用 NDIS_WWAN_PREFERRED_PROVIDERS

NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1

NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1

NDIS_STATUS_WWAN_VISIBLE_PROVIDERS

使用 NDIS_WWAN_VISIBLE_PROVIDERS

NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1

NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1

NDIS_STATUS_WWAN_REGISTER_STATE

使用 NDIS_WWAN_REGISTRATION_STATE

NDIS_WWAN_REGISTRATION_STATE_REVISION_1

NDIS_WWAN_REGISTRATION_STATE_REVISION_2

NDIS_STATUS_WWAN_SIGNAL_STATE

使用 NDIS_WWAN_SIGNAL_STATE

NDIS_WWAN_SIGNAL_STATE_REVISION_1

NDIS_WWAN_SIGNAL_STATE_REVISION_1

NDIS_STATUS_WWAN_PACKET_SERVICE

使用 NDIS_WWAN_PACKET_SERVICE_STATE

NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1

NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1

NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS

使用 NDIS_WWAN_PROVISIONED_CONTEXTS

NDIS_WWAN_PROVISIONED_CONTEXTS_REVISION_1

NDIS_WWAN_PROVISIONED_CONTEXTS_REVISION_1

NDIS_STATUS_WWAN_CONTEXT_STATE

使用 NDIS_WWAN_CONTEXT_STATE

NDIS_WWAN_CONTEXT_STATE_REVISION_1

NDIS_WWAN_CONTEXT_STATE_REVISION_1

NDIS_STATUS_WWAN_SMS_CONFIGURATION

使用 NDIS_WWAN_SMS_CONFIGURATION

NDIS_WWAN_SMS_CONFIGURATION_REVISION_1

NDIS_WWAN_SMS_CONFIGURATION_REVISION_1

NDIS_STATUS_WWAN_SMS_RECEIVE

使用 NDIS_WWAN_SMS_RECEIVE

NDIS_WWAN_SMS_RECEIVE_REVISION_1

NDIS_WWAN_SMS_RECEIVE_REVISION_1

NDIS_STATUS_WWAN_SMS_SEND

使用 NDIS_WWAN_SMS_SEND_STATUS

NDIS_WWAN_SMS_SEND_STATUS_REVISION_1

NDIS_WWAN_SMS_SEND_STATUS_REVISION_1

NDIS_STATUS_WWAN_SMS_DELETE

使用 NDIS_WWAN_SMS_DELETE_STATUS

NDIS_WWAN_SMS_DELETE_STATUS_REVISION_1

NDIS_WWAN_SMS_DELETE_STATUS_REVISION_1

NDIS_STATUS_WWAN_SMS_STATUS

使用 NDIS_WWAN_SMS_STATUS

NDIS_WWAN_SMS_STATUS_REVISION_1

NDIS_WWAN_SMS_STATUS_REVISION_1

NDIS_STATUS_WWAN_VENDOR_SPECIFIC

使用供应商定义的结构

不适用

NDIS_STATUS_WWAN_USSD

使用 NDIS_WWAN_USSD_EVENT

NDIS_WWAN_USSD_EVENT_REVISION_1

NDIS_WWAN_USSD_EVENT_REVISION_1

NDIS_STATUS_WWAN_DEVICE_SERVICE_SUPPORTED_COMMANDS

使用 NDIS_WWAN_DEVICE_SERVICE_SUPPORTED_COMMANDS

NDIS_WWAN_DEVICE_SERVICES_REVISION_1

NDIS_WWAN_DEVICE_SERVICES_REVISION_1

NDIS_STATUS_WWAN_DEVICE_SERVICE_RESPONSE

使用 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

使用 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

使用 NDIS_WWAN_DEVICE_SERVICE_SUBSCRIPTION

NDIS_WWAN_DEVICE_SERVICE_SUBSCRIPTION_REVISION_1

NDIS_WWAN_DEVICE_SERVICE_SUBSCRIPTION_REVISION_1

NDIS_STATUS_WWAN_AUTH_RESPONSE

使用 NDIS_WWAN_AUTH_RESPONSE

NDIS_WWAN_AUTH_RESPONSE_REVISION_1

NDIS_WWAN_AUTH_RESPONSE_REVISION_1

NDIS_STATUS_WWAN_SET_HOME_PROVIDER_COMPLETE

使用 NDIS_WWAN_SET_HOME_PROVIDER

不适用

NDIS_WWAN_HOME_PROVIDER_REVISION_2

注意

 以下说明适用于上表:†表示微型端口驱动程序可能支持的可选指示。 请注意,如果微型端口驱动程序支持可选的 OID,则微型端口驱动程序还应支持相应的指示。 

对 GSM、CDMA 和未经请求的指示WWAN-Specific指示支持

指示

GSM

CDMA

不 请 自来

指示

允许?

NDIS_STATUS_WWAN_DEVICE_CAPS

X

X

N

NDIS_STATUS_WWAN_READY_INFO

X

X

Y

NDIS_STATUS_WWAN_RADIO_STATE

X

X

Y

NDIS_STATUS_WWAN_PIN_INFO

X

X

N

NDIS_STATUS_WWAN_PIN_LIST

X

X

N

NDIS_STATUS_WWAN_SERVICE_ACTIVATION

X

X

N

NDIS_STATUS_WWAN_HOME_PROVIDER

X

X

N

NDIS_STATUS_WWAN_PREFERRED_PROVIDERS

X

Y

NDIS_STATUS_WWAN_VISIBLE_PROVIDERS

X

X

N

NDIS_STATUS_WWAN_REGISTER_STATE

X

X

Y

NDIS_STATUS_WWAN_SIGNAL_STATE

X

X

Y

NDIS_STATUS_WWAN_PACKET_SERVICE

使用 NDIS_WWAN_PACKET_SERVICE_STATE

X

X

Y

NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS

X

X

Y

NDIS_STATUS_WWAN_CONTEXT_STATE

X

X

Y

NDIS_STATUS_WWAN_SMS_CONFIGURATION

X

X

Y

NDIS_STATUS_WWAN_SMS_RECEIVE

X

X

Y

NDIS_STATUS_WWAN_SMS_SEND

使用 NDIS_WWAN_SMS_SEND_STATUS

X

X

N

NDIS_STATUS_WWAN_SMS_DELETE

X

X

N

NDIS_STATUS_WWAN_SMS_STATUS

X

X

Y

NDIS_STATUS_WWAN_VENDOR_SPECIFIC

X

X

Y

NDIS_STATUS_WWAN_USSD

X

Y

NDIS_STATUS_WWAN_DEVICE_SERVICE_SUPPORTED_COMMANDS

X

X

N

NDIS_STATUS_WWAN_DEVICE_SERVICE_RESPONSE

X

X

N

NDIS_STATUS_WWAN_DEVICE_SERVICE_EVENT

X

X

Y

NDIS_STATUS_WWAN_DEVICE_SERVICE_SUBSCRIPTION

X

X

N

NDIS_STATUS_WWAN_AUTH_RESPONSE

X

X

N

NDIS_STATUS_WWAN_SET_HOME_PROVIDER_COMPLETE

X

X

N

 

多运营商特定的 OID

以下更改适用于支持多运营商模式的 NDIS 6.30 微型端口驱动程序。 如果微型端口驱动程序不支持多运营商模式,请参阅上表。

OIDWindows 8相应的数据结构

查询操作

设置操作

GSM/CDMA

OID_WWAN_HOME_PROVIDER

使用 NDIS_WWAN_SET_HOME_PROVIDER

A

A

GSM、CDMA

OID_WWAN_PREFERRED_MULTICARRIER_PROVIDERS

使用 NDIS_WWAN_SET_PREFERRED_MULTICARRIER_PROVIDERSPreferredListHeader.ElementType 应设置为 WwanStructProvider2,并且结构WWAN_PROVIDER2。

A

A

GSM、CDMA

 

多运营商特定指示、相应的数据结构和 OS 修订

指示相应的数据结构

Windows 8 修订版

NDIS_STATUS_WWAN_HOME_PROVIDER

使用 NDIS_WWAN_HOME_PROVIDER2

NDIS_WWAN_HOME_PROVIDER_REVISION_2

NDIS_STATUS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS

使用 NDIS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS

NDIS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS_REVISION_1。 PreferredListHeader.ElementType 应设置为 WwanStructProvider2,并且列表应包含WWAN_PROVIDER2结构。

NDIS_STATUS_WWAN_VISIBLE_PROVIDERS

使用 NDIS_WWAN_VISIBLE_PROVIDERS

NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1。 VisibleListHeader.ElementType 应设置为 WwanStructProvider2,并且列表应包含WWAN_PROVIDER2结构。

 

对 GSM、CDMA 和主动指示的多运营商特定指示支持

指示相应的数据结构

GSM

CDMA

不 请 自来

指示

允许?

NDIS_STATUS_WWAN_HOME_PROVIDER

X

X

N

NDIS_STATUS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS

X

X

Y

NDIS_STATUS_WWAN_VISIBLE_PROVIDERS

使用 NDIS_WWAN_VISIBLE_PROVIDERS

X

X

N