Modèle de données MB
Le modèle de pilote Mo utilise un modèle de données qui se compose d’un ensemble d’objets définis en tant qu’abstractions des fonctionnalités d’appareil Mo. Chaque objet est identifié par un identificateur d’objet unique (OID) et est défini par un ensemble d’attributs correspondants. L’ensemble d’attributs est organisé dans une structure de données. Pour gérer l’appareil, le service MB et le pilote miniport MO échangent des OID et leurs structures de données associées en fonction des demandes OID et des indications fournies par la spécification NDIS (Network Driver Interface Specification).
Dans le modèle de pilote Mo, seules les opérations de définition et de requête sont utilisées pour les requêtes OID. Le modèle de pilote Mo n’utilise pas d’opérations de méthode . Pour obtenir des indications, le modèle de pilote Mo utilise à la fois des notifications d’événement et transactionnelles pour indiquer les changements d’état dans les objets de l’appareil Mo. Les notifications transactionnelles signalent également l’achèvement d’une transaction asynchrone.
Les tableaux suivants répertorient les OID et status indications définies pour les pilotes miniport Mo, ainsi que les structures de données associées. Les pilotes miniport MB doivent implémenter tous les OID généraux obligatoires requis par la spécification NDIS 6.20. Pour obtenir la liste des OID généraux pour NDIS 6.x, consultez OID opérationnels généraux.
En outre, les pilotes mo miniport doivent implémenter OID_GEN_PHYSICAL_MEDIUM même si la spécification NDIS le décrit comme facultatif à implémenter.
La syntaxe et la sémantique des OID MB répertoriées dans le tableau suivant sont décrites dans La sémantique opérationnelle mo.
WWAN-Specific OID
| OID et structure de données correspondante | Set, Windows 7 | Set, Windows 8 | Requête, Windows 7 | Requête, Windows 8 | GSM/CDMA |
|---|---|---|---|---|---|
| OID_WWAN_DRIVER_CAPS utilise NDIS_WWAN_DRIVER_CAPS | Non pris en charge | Non prise en charge | S | S | GSM, CDMA |
| OID_WWAN_DEVICE_CAPS n’a pas de structure correspondante | Non pris en charge | Non prise en charge | A | A | GSM, CDMA |
| OID_WWAN_READY_INFO n’a pas de structure correspondante | Non pris en charge Non pris en charge | A | A | GSM, CDMA | |
| OID_WWAN_SERVICE_ACTIVATION† utilise NDIS_WWAN_SERVICE_ACTIVATION | A | A | Non prise en charge | Non prise en charge | GSM, CDMA |
| OID_WWAN_RADIO_STATE utilise NDIS_WWAN_SET_RADIO_STATE | A | A | A | A | GSM, CDMA |
| OID_WWAN_PIN utilise NDIS_WWAN_SET_PIN | A | Non pris en charge | A | Non prise en charge | GSM, CDMA |
| OID_WWAN_PIN_LIST n’a pas de structure correspondante | Non prise en charge | Non prise en charge | A | A | GSM, CDMA |
| OID_WWAN_PIN_EX utilise NDIS_WWAN_SET_PIN_EX | Non prise en charge | A | Non prise en charge | A | GSM, CDMA |
| OID_WWAN_HOME_PROVIDER n’a pas de structure correspondante | Non prise en charge | Non prise en charge | A | A | GSM, CDMA |
| OID_WWAN_PREFERRED_PROVIDERS† utilise NDIS_WWAN_SET_PREFERRED_PROVIDERS | A | A | A | A | GSM uniquement |
| OID_WWAN_VISIBLE_PROVIDERS n’a pas de structure correspondante | Non pris en charge | Non prise en charge | A | A | GSM |
| OID_WWAN_REGISTER_STATE utilise NDIS_WWAN_SET_REGISTER_STATE | A | A | A | A | CDMA |
| OID_WWAN_SIGNAL_STATE utilise NDIS_WWAN_SET_SIGNAL_INDICATION | A | A | A | A | GSM, CDMA |
| OID_WWAN_PACKET_SERVICE utilise NDIS_WWAN_SET_PACKET_SERVICE | A | A | A | A | GSM, CDMA |
| OID_WWAN_PROVISIONED_CONTEXTS†† utilise NDIS_WWAN_SET_PROVISIONED_CONTEXT | A | A | A | A | GSM, CDMA |
| OID_WWAN_CONNECT utilise NDIS_WWAN_SET_CONTEXT_STATE | A | A | A | A | GSM, CDMA |
| OID_WWAN_SMS_CONFIGURATION utilise NDIS_WWAN_SET_SMS_CONFIGURATION | A | A | A | A | GSM, CDMA |
| OID_WWAN_SMS_READ utilise NDIS_WWAN_SMS_READ | Non prise en charge | A | A | A | GSM, CDMA |
| OID_WWAN_SMS_SEND utilise NDIS_WWAN_SMS_SEND | A | A | Non prise en charge | Non prise en charge | GSM, CDMA |
| OID_WWAN_SMS_DELETE utilise NDIS_WWAN_SMS_DELETE | A | A | Non prise en charge | Non prise en charge | GSM, CDMA |
| OID_WWAN_SMS_STATUS utilise NDIS_WWAN_SMS_STATUS | Non pris en charge | Non prise en charge | A | A | GSM, CDMA |
| OID_WWAN_VENDOR_SPECIFIC† utilise une structure définie par le fournisseur | A | A | Non pris en charge | Non pris en charge | GSM, CDMA |
| OID_WWAN_DEVICE_SERVICES n’a pas de structure correspondante | Non pris en charge | Non pris en charge | Non pris en charge | A | GSM, CDMA |
| OID_WWAN_SUBSCRIBE_DEVICE_SERVICE_EVENTS utilise NDIS_WWAN_SUBSCRIBE_DEVICE_SERVICE_EVENTS | Non pris en charge | A | Non pris en charge | Non pris en charge | GSM, CDMA |
| OID_WWAN_AUTH_CHALLENGE utilise NDIS_WWAN_AUTH_CHALLENGE | Non pris en charge | Non pris en charge | Non pris en charge | A | GSM, CDMA |
| OID_WWAN_USSD utilise NDIS_WWAN_USSD_REQUEST | Non pris en charge | A | Non pris en charge | Non pris en charge | GSM |
| OID_WWAN_DEVICE_SERVICE_COMMAND utilise NDIS_WWAN_DEVICE_SERVICE_COMMAND | Non pris en charge | A | Non pris en charge | A | GSM, CDMA |
Notes
Les remarques suivantes s’appliquent au tableau précédent : † représente les OID facultatifs que les pilotes miniport peuvent prendre en charge. Les pilotes miniport qui ne prennent pas en charge les OID facultatifs ne doivent pas les retourner dans OID_GEN_SUPPORTED_LIST.
†† représente les pilotes miniport qui prennent en charge les appareils GSM qui peuvent éventuellement prendre en charge OID_WWAN_PROVISIONED_CONTEXTS opérations de définition et d’interrogation. Les pilotes miniport qui prennent en charge les appareils CDMA peuvent éventuellement prendre en charge les opérations de requête OID_WWAN_PROVISIONED_CONTEXTS pour les appareils CDMA qui signalent une adresse IP simple (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP).
Les pilotes Miniport doivent prendre en charge tous les OID non facultatifs. Le service MB peut ignorer tout pilote miniport qui ne signale pas tous les OID obligatoires.
« A » et « S » dans les colonnes d’opération Set et Query de la table précédente reflètent la nature de la transaction pour l’exécution de la requête OID : « A » signifie une transaction asynchrone et « S » pour une transaction synchrone.
Les structures de données de la table précédente correspondent à des OID d’opération de définition et à des données retournées pour les OID d’opération de requête synchrone.
Les OID suivants partagent une structure de données de liste de longueur variable commune appelée WWAN_LIST_HEADER dans leurs structures de données correspondantes :
- OID_WWAN_READY_INFO
- OID_WWAN_PREFERRED_PROVIDERS
- OID_WWAN_VISIBLE_PROVIDERS
- OID_WWAN_PROVISIONED_CONTEXTS
- OID_WWAN_SMS_READ
indications WWAN-Specific, structures de données correspondantes et révisions du système d’exploitation
Indication et structure de données correspondante |
Révision de Windows 7 révision Windows 8 |
|
utilise NDIS_WWAN_DEVICE_CAPS |
NDIS_WWAN_DEVICE_CAPS_REVISION_1 NDIS_WWAN_DEVICE_CAPS_REVISION_2 |
|
utilise NDIS_WWAN_READY_INFO |
NDIS_WWAN_READY_INFO_REVISION_1 NDIS_WWAN_READY_INFO_REVISION_1 |
|
utilise NDIS_WWAN_RADIO_STATE |
NDIS_WWAN_RADIO_STATE_REVISION_1 NDIS_WWAN_RADIO_STATE_REVISION_1 |
|
utilise NDIS_WWAN_PIN_INFO |
NDIS_WWAN_PIN_INFO_REVISION_1 NDIS_WWAN_PIN_INFO_REVISION_1 |
|
utilise NDIS_WWAN_PIN_LIST |
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_STATUS_WWAN_HOME_PROVIDER utilise NDIS_WWAN_HOME_PROVIDER |
NDIS_WWAN_HOME_PROVIDER_REVISION_1 NDIS_WWAN_HOME_PROVIDER_REVISION_1 |
NDIS_STATUS_WWAN_PREFERRED_PROVIDERS† utilise NDIS_WWAN_PREFERRED_PROVIDERS |
NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1 NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1 |
NDIS_STATUS_WWAN_VISIBLE_PROVIDERS utilise NDIS_WWAN_VISIBLE_PROVIDERS |
NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1 NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1 |
NDIS_STATUS_WWAN_REGISTER_STATE utilise NDIS_WWAN_REGISTRATION_STATE |
NDIS_WWAN_REGISTRATION_STATE_REVISION_1 NDIS_WWAN_REGISTRATION_STATE_REVISION_2 |
|
utilise NDIS_WWAN_SIGNAL_STATE |
NDIS_WWAN_SIGNAL_STATE_REVISION_1 NDIS_WWAN_SIGNAL_STATE_REVISION_1 |
NDIS_STATUS_WWAN_PACKET_SERVICE utilise NDIS_WWAN_PACKET_SERVICE_STATE |
NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1 NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1 |
NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS utilise NDIS_WWAN_PROVISIONED_CONTEXTS |
NDIS_WWAN_PROVISIONED_CONTEXTS_REVISION_1 NDIS_WWAN_PROVISIONED_CONTEXTS_REVISION_1 |
NDIS_STATUS_WWAN_CONTEXT_STATE utilise NDIS_WWAN_CONTEXT_STATE |
NDIS_WWAN_CONTEXT_STATE_REVISION_1 NDIS_WWAN_CONTEXT_STATE_REVISION_1 |
NDIS_STATUS_WWAN_SMS_CONFIGURATION utilise NDIS_WWAN_SMS_CONFIGURATION |
NDIS_WWAN_SMS_CONFIGURATION_REVISION_1 NDIS_WWAN_SMS_CONFIGURATION_REVISION_1 |
|
utilise NDIS_WWAN_SMS_RECEIVE |
NDIS_WWAN_SMS_RECEIVE_REVISION_1 NDIS_WWAN_SMS_RECEIVE_REVISION_1 |
|
utilise NDIS_WWAN_SMS_SEND_STATUS |
NDIS_WWAN_SMS_SEND_STATUS_REVISION_1 NDIS_WWAN_SMS_SEND_STATUS_REVISION_1 |
|
utilise NDIS_WWAN_SMS_DELETE_STATUS |
NDIS_WWAN_SMS_DELETE_STATUS_REVISION_1 NDIS_WWAN_SMS_DELETE_STATUS_REVISION_1 |
|
utilise NDIS_WWAN_SMS_STATUS |
NDIS_WWAN_SMS_STATUS_REVISION_1 NDIS_WWAN_SMS_STATUS_REVISION_1 |
NDIS_STATUS_WWAN_VENDOR_SPECIFIC† utilise une structure définie par le fournisseur |
N/A |
|
utilise 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_WWAN_DEVICE_SERVICE_RESPONSE_REVISION_1 NDIS_WWAN_DEVICE_SERVICE_RESPONSE_REVISION_1 |
|
NDIS_STATUS_WWAN_DEVICE_SERVICE_EVENT utilise NDIS_WWAN_DEVICE_SERVICE_EVENT |
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_STATUS_WWAN_AUTH_RESPONSE utilise NDIS_WWAN_AUTH_RESPONSE |
NDIS_WWAN_AUTH_RESPONSE_REVISION_1 NDIS_WWAN_AUTH_RESPONSE_REVISION_1 |
NDIS_STATUS_WWAN_SET_HOME_PROVIDER_COMPLETE utilise NDIS_WWAN_SET_HOME_PROVIDER |
N/A NDIS_WWAN_HOME_PROVIDER_REVISION_2 |
Notes
Les remarques suivantes s’appliquent au tableau précédent : † représente des indications facultatives que les pilotes miniport peuvent prendre en charge. N’oubliez pas que si un pilote miniport prend en charge un OID facultatif, le pilote miniport doit également prendre en charge l’indication correspondante.
prise en charge des indications WWAN-Specific pour GSM, CDMA et indications non sollicitées
Indication |
GSM |
CDMA |
Non sollicitées Indication Autorisé? |
X |
X |
N |
|
X |
X |
O |
|
X |
X |
O |
|
X |
X |
N |
|
X |
X |
N |
|
X |
X |
N |
|
X |
X |
N |
|
X |
O |
||
X |
X |
N |
|
X |
X |
O |
|
X |
X |
O |
|
NDIS_STATUS_WWAN_PACKET_SERVICE utilise NDIS_WWAN_PACKET_SERVICE_STATE |
X |
X |
O |
X |
X |
O |
|
X |
X |
O |
|
X |
X |
O |
|
X |
X |
O |
|
|
utilise NDIS_WWAN_SMS_SEND_STATUS |
X |
X |
N |
X |
X |
N |
|
X |
X |
O |
|
X |
X |
O |
|
X |
O |
||
X |
X |
N |
|
X |
X |
N |
|
X |
X |
O |
|
X |
X |
N |
|
X |
X |
N |
|
X |
X |
N |
OID spécifiques à plusieurs opérateurs
Les modifications suivantes s’appliquent aux pilotes miniport NDIS 6.30 qui prennent en charge le mode multifacteur. Si le pilote miniport ne prend pas en charge le mode multifacteur, reportez-vous au tableau précédent.
OID et Windows 8 structure de données correspondante |
Opération de requête |
Définir l’opération |
GSM/CDMA |
|
utilise NDIS_WWAN_SET_HOME_PROVIDER |
A |
A |
GSM, CDMA |
OID_WWAN_PREFERRED_MULTICARRIER_PROVIDERS utilise NDIS_WWAN_SET_PREFERRED_MULTICARRIER_PROVIDERS. Le PreferredListHeader.ElementType doit être défini sur WwanStructProvider2 et la structure est WWAN_PROVIDER2. |
A |
A |
GSM, CDMA |
Indications spécifiques multifacteur, structures de données correspondantes et révisions du système d’exploitation
Indication et structure de données correspondante |
révision Windows 8 |
NDIS_STATUS_WWAN_HOME_PROVIDER utilise NDIS_WWAN_HOME_PROVIDER2 |
NDIS_WWAN_HOME_PROVIDER_REVISION_2 |
NDIS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS_REVISION_1. Le PreferredListHeader.ElementType doit être défini sur WwanStructProvider2 et la liste doit contenir WWAN_PROVIDER2 structure. |
|
NDIS_STATUS_WWAN_VISIBLE_PROVIDERS utilise NDIS_WWAN_VISIBLE_PROVIDERS |
NDIS_WWAN_VISIBLE_PROVIDERS_REVISION_1. VisibleListHeader.ElementType doit être défini sur WwanStructProvider2 et la liste doit contenir WWAN_PROVIDER2 structure. |
Prise en charge des indications spécifiques multifacteur pour gsm, CDMA et indications non sollicitées
Indication et structure de données correspondante |
GSM |
CDMA |
Non sollicitées Indication Autorisé? |
X |
X |
N |
|
X |
X |
O |
|
NDIS_STATUS_WWAN_VISIBLE_PROVIDERS utilise NDIS_WWAN_VISIBLE_PROVIDERS |
X |
X |
N |