Modelo de dados MB
O modelo de driver MB usa um modelo de dados que consiste em um conjunto de objetos definidos como abstrações de recursos de dispositivo MB. Cada objeto é identificado por um OID (identificador de objeto) exclusivo e é definido por um conjunto de atributos correspondentes. O conjunto de atributos é organizado em uma estrutura de dados. Para gerenciar o dispositivo, o Serviço MB e o driver de miniporto MB trocam OIDs e suas estruturas de dados associadas com base em solicitações de OID e indicações fornecidas pela NDIS (Especificação da Interface do Driver de Rede).
No modelo de driver MB, somente as operações de definição e consulta são usadas para solicitações OID. O modelo de driver MB não usa operações de método . Para indicações, o modelo de driver MB usa notificações transacionais e de evento para indicar alterações de estado nos objetos do dispositivo MB. As notificações transacionais também sinalizam a conclusão de uma transação assíncrona.
As tabelas a seguir listam as OIDs e status indicações definidas para drivers de miniporto MB, bem como as estruturas de dados associadas. Os drivers de miniporto MB devem implementar todos os OIDs gerais obrigatórios exigidos pela Especificação NDIS 6.20. Para obter uma lista de OIDs gerais para NDIS 6.x, consulte OIDs operacionais gerais.
Além disso, os drivers de miniporto MB devem implementar OID_GEN_PHYSICAL_MEDIUM mesmo que a Especificação do NDIS a descreva como opcional para implementar.
A sintaxe e a semântica dos OIDs mb listados na tabela a seguir são descritos em Semântica Operacional de MB.
WWAN-Specific OIDs
| OID e estrutura de dados correspondentes | Set, Windows 7 | Definir, Windows 8 | Consulta, Windows 7 | Consulta, Windows 8 | GSM/CDMA |
|---|---|---|---|---|---|
| OID_WWAN_DRIVER_CAPS usa NDIS_WWAN_DRIVER_CAPS | Sem suporte | Sem suporte | S | S | GSM, CDMA |
| OID_WWAN_DEVICE_CAPS não tem estrutura correspondente | Sem suporte | Sem suporte | A | A | GSM, CDMA |
| OID_WWAN_READY_INFO não tem nenhuma estrutura correspondente | Sem suporte Sem suporte | A | A | GSM, CDMA | |
| OID_WWAN_SERVICE_ACTIVATION† usa NDIS_WWAN_SERVICE_ACTIVATION | A | A | Sem suporte | Sem suporte | GSM, CDMA |
| OID_WWAN_RADIO_STATE usa NDIS_WWAN_SET_RADIO_STATE | A | A | A | A | GSM, CDMA |
| OID_WWAN_PIN usa NDIS_WWAN_SET_PIN | A | Sem suporte | A | Sem suporte | GSM, CDMA |
| OID_WWAN_PIN_LIST não tem estrutura correspondente | Sem suporte | Sem suporte | A | A | GSM, CDMA |
| OID_WWAN_PIN_EX usa NDIS_WWAN_SET_PIN_EX | Sem suporte | A | Sem suporte | A | GSM, CDMA |
| OID_WWAN_HOME_PROVIDER não tem estrutura correspondente | Sem suporte | Sem suporte | A | A | GSM, CDMA |
| OID_WWAN_PREFERRED_PROVIDERS† usa NDIS_WWAN_SET_PREFERRED_PROVIDERS | A | A | A | A | Somente GSM |
| OID_WWAN_VISIBLE_PROVIDERS não tem estrutura correspondente | Sem suporte | Sem suporte | A | A | GSM |
| OID_WWAN_REGISTER_STATE usa NDIS_WWAN_SET_REGISTER_STATE | A | A | A | A | CDMA |
| OID_WWAN_SIGNAL_STATE usa NDIS_WWAN_SET_SIGNAL_INDICATION | A | A | A | A | GSM, CDMA |
| OID_WWAN_PACKET_SERVICE usa NDIS_WWAN_SET_PACKET_SERVICE | A | A | A | A | GSM, CDMA |
| OID_WWAN_PROVISIONED_CONTEXTS†† usa NDIS_WWAN_SET_PROVISIONED_CONTEXT | A | A | A | A | GSM, CDMA |
| OID_WWAN_CONNECT usa NDIS_WWAN_SET_CONTEXT_STATE | A | A | A | A | GSM, CDMA |
| OID_WWAN_SMS_CONFIGURATION usa NDIS_WWAN_SET_SMS_CONFIGURATION | A | A | A | A | GSM, CDMA |
| OID_WWAN_SMS_READ usa NDIS_WWAN_SMS_READ | Sem suporte | A | A | A | GSM, CDMA |
| OID_WWAN_SMS_SEND usa NDIS_WWAN_SMS_SEND | A | A | Sem suporte | Sem suporte | GSM, CDMA |
| OID_WWAN_SMS_DELETE usa NDIS_WWAN_SMS_DELETE | A | A | Sem suporte | Sem suporte | GSM, CDMA |
| OID_WWAN_SMS_STATUS usa NDIS_WWAN_SMS_STATUS | Sem suporte | Sem suporte | A | A | GSM, CDMA |
| OID_WWAN_VENDOR_SPECIFIC† usa uma estrutura definida pelo fornecedor | A | A | Sem suporte | Sem suporte | GSM, CDMA |
| OID_WWAN_DEVICE_SERVICES não tem nenhuma estrutura correspondente | Sem suporte | Sem suporte | Sem suporte | A | GSM, CDMA |
| OID_WWAN_SUBSCRIBE_DEVICE_SERVICE_EVENTS usa NDIS_WWAN_SUBSCRIBE_DEVICE_SERVICE_EVENTS | Sem suporte | A | Sem suporte | Sem suporte | GSM, CDMA |
| OID_WWAN_AUTH_CHALLENGE usa NDIS_WWAN_AUTH_CHALLENGE | Sem suporte | Sem suporte | Sem suporte | A | GSM, CDMA |
| OID_WWAN_USSD usa NDIS_WWAN_USSD_REQUEST | Sem suporte | A | Sem suporte | Sem suporte | GSM |
| OID_WWAN_DEVICE_SERVICE_COMMAND usa NDIS_WWAN_DEVICE_SERVICE_COMMAND | Sem suporte | A | Sem suporte | A | GSM, CDMA |
Observação
As seguintes notas se aplicam à tabela anterior: † representa OIDs opcionais aos quais os drivers de miniporto podem dar suporte. Os drivers de miniport que não dão suporte aos OIDs opcionais não devem devolvê-los em OID_GEN_SUPPORTED_LIST.
†† representa drivers de miniporte que dão suporte a dispositivos baseados em GSM que, opcionalmente, podem dar suporte a OID_WWAN_PROVISIONED_CONTEXTS operações de definição e consulta. Os drivers de miniport que dão suporte a dispositivos baseados em CDMA podem, opcionalmente, dar suporte a operações de consulta OID_WWAN_PROVISIONED_CONTEXTS para dispositivos baseados em CDMA que relatam IP simples (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP).
Os drivers de miniport devem dar suporte a todos os OIDs não opcionais. O Serviço MB pode ignorar qualquer driver de miniporto que não relate todos os OIDs obrigatórios.
"A" e "S" nas colunas de operação Definir e Consultar na tabela anterior refletem a natureza da transação para concluir a solicitação OID: "A" significa uma transação assíncrona e "S" para uma transação síncrona.
As estruturas de dados na tabela anterior correspondem a definir OIDs de operação e retornar dados para OIDs da operação de consulta síncrona.
Os seguintes OIDs compartilham uma estrutura de dados de lista de comprimento variável comum chamada WWAN_LIST_HEADER em suas estruturas de dados correspondentes:
- OID_WWAN_READY_INFO
- OID_WWAN_PREFERRED_PROVIDERS
- OID_WWAN_VISIBLE_PROVIDERS
- OID_WWAN_PROVISIONED_CONTEXTS
- OID_WWAN_SMS_READ
Indicações de WWAN-Specific, estruturas de dados correspondentes e revisões do sistema operacional
Indicação e estrutura de dados correspondente |
Revisão do Windows 7 Revisão de Windows 8 |
NDIS_WWAN_DEVICE_CAPS_REVISION_1 NDIS_WWAN_DEVICE_CAPS_REVISION_2 |
|
NDIS_WWAN_READY_INFO_REVISION_1 NDIS_WWAN_READY_INFO_REVISION_1 |
|
NDIS_WWAN_RADIO_STATE_REVISION_1 NDIS_WWAN_RADIO_STATE_REVISION_1 |
|
NDIS_WWAN_PIN_INFO_REVISION_1 NDIS_WWAN_PIN_INFO_REVISION_1 |
|
NDIS_WWAN_PIN_LIST_REVISION_1 NDIS_WWAN_PIN_LIST_REVISION_1 |
|
NDIS_WWAN_SERVICE_ACTIVATION_STATUS_REVISION_1 NDIS_WWAN_SERVICE_ACTIVATION_STATUS_REVISION_1 |
|
NDIS_WWAN_HOME_PROVIDER_REVISION_1 NDIS_WWAN_HOME_PROVIDER_REVISION_1 |
|
NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1 NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1 |
|
NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1 NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1 |
|
NDIS_WWAN_REGISTRATION_STATE_REVISION_1 NDIS_WWAN_REGISTRATION_STATE_REVISION_2 |
|
NDIS_WWAN_SIGNAL_STATE_REVISION_1 NDIS_WWAN_SIGNAL_STATE_REVISION_1 |
|
NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1 NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1 |
|
NDIS_WWAN_PROVISIONED_CONTEXTS_REVISION_1 NDIS_WWAN_PROVISIONED_CONTEXTS_REVISION_1 |
|
NDIS_WWAN_CONTEXT_STATE_REVISION_1 NDIS_WWAN_CONTEXT_STATE_REVISION_1 |
|
NDIS_WWAN_SMS_CONFIGURATION_REVISION_1 NDIS_WWAN_SMS_CONFIGURATION_REVISION_1 |
|
NDIS_WWAN_SMS_RECEIVE_REVISION_1 NDIS_WWAN_SMS_RECEIVE_REVISION_1 |
|
NDIS_WWAN_SMS_SEND_STATUS_REVISION_1 NDIS_WWAN_SMS_SEND_STATUS_REVISION_1 |
|
NDIS_WWAN_SMS_DELETE_STATUS_REVISION_1 NDIS_WWAN_SMS_DELETE_STATUS_REVISION_1 |
|
NDIS_WWAN_SMS_STATUS_REVISION_1 NDIS_WWAN_SMS_STATUS_REVISION_1 |
|
NDIS_STATUS_WWAN_VENDOR_SPECIFIC† usa uma estrutura definida pelo fornecedor |
N/D |
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_WWAN_DEVICE_SERVICE_RESPONSE_REVISION_1 NDIS_WWAN_DEVICE_SERVICE_RESPONSE_REVISION_1 |
|
NDIS_WWAN_DEVICE_SERVICE_EVENT_REVISION_1 NDIS_WWAN_DEVICE_SERVICE_EVENT_REVISION_1 |
|
NDIS_WWAN_DEVICE_SERVICE_SUBSCRIPTION_REVISION_1 NDIS_WWAN_DEVICE_SERVICE_SUBSCRIPTION_REVISION_1 |
|
NDIS_WWAN_AUTH_RESPONSE_REVISION_1 NDIS_WWAN_AUTH_RESPONSE_REVISION_1 |
|
N/D NDIS_WWAN_HOME_PROVIDER_REVISION_2 |
Observação
As seguintes notas se aplicam à tabela anterior: † representa indicações opcionais de que os drivers de miniporte podem dar suporte. Lembre-se de que, se um driver de miniporto der suporte a um OID opcional, o driver de miniport também deverá dar suporte à indicação correspondente.
suporte de indicação WWAN-Specific para GSM, CDMA e indicações não solicitadas
Indicação |
GSM |
CDMA |
Espontâneos Indicação Permitido? |
X |
X |
N |
|
X |
X |
S |
|
X |
X |
S |
|
X |
X |
N |
|
X |
X |
N |
|
X |
X |
N |
|
X |
X |
N |
|
X |
S |
||
X |
X |
N |
|
X |
X |
S |
|
X |
X |
S |
|
X |
X |
S |
|
X |
X |
S |
|
X |
X |
S |
|
X |
X |
S |
|
X |
X |
S |
|
X |
X |
N |
|
X |
X |
N |
|
X |
X |
S |
|
X |
X |
S |
|
X |
S |
||
X |
X |
N |
|
X |
X |
N |
|
X |
X |
S |
|
X |
X |
N |
|
X |
X |
N |
|
X |
X |
N |
OIDs específicos de várias operadoras
As alterações a seguir se aplicam aos drivers de miniporta NDIS 6.30 que dão suporte ao modo de várias operadoras. Se o driver de miniporta não der suporte ao modo de várias operadoras, consulte a tabela anterior.
Estrutura de dados correspondente de OID e Windows 8 |
Operação de consulta |
Definir Operação |
GSM/CDMA |
A |
A |
GSM, CDMA |
|
OID_WWAN_PREFERRED_MULTICARRIER_PROVIDERS usa NDIS_WWAN_SET_PREFERRED_MULTICARRIER_PROVIDERS. O PreferredListHeader.ElementType deve ser definido como WwanStructProvider2 e a estrutura é WWAN_PROVIDER2. |
A |
A |
GSM, CDMA |
Indicações específicas de várias operadoras, estruturas de dados correspondentes e revisões do sistema operacional
Indicação e estrutura de dados correspondente |
Revisão Windows 8 |
NDIS_WWAN_HOME_PROVIDER_REVISION_2 |
|
NDIS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS_REVISION_1. O PreferredListHeader.ElementType deve ser definido como WwanStructProvider2 e a lista deve conter WWAN_PROVIDER2 estrutura. |
|
NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1. O VisibleListHeader.ElementType deve ser definido como WwanStructProvider2 e a lista deve conter WWAN_PROVIDER2 estrutura. |
Suporte de indicação específica de várias operadoras para GSM, CDMA e indicações não solicitadas
Indicação e estrutura de dados correspondente |
GSM |
CDMA |
Espontâneos Indicação Permitido? |
X |
X |
N |
|
X |
X |
S |
|
X |
X |
N |