структура NDIS_WWAN_PREFERRED_PROVIDERS (ndiswwan.h)
Структура NDIS_WWAN_PREFERRED_PROVIDERS представляет список предпочтительных поставщиков, включая количество поставщиков в списке.
Синтаксис
typedef struct _NDIS_WWAN_PREFERRED_PROVIDERS {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_LIST_HEADER PreferredListHeader;
} NDIS_WWAN_PREFERRED_PROVIDERS, *PNDIS_WWAN_PREFERRED_PROVIDERS;
Члены
Header
Заголовок с сведениями о типе, редакции и размере структуры NDIS_WWAN_PREFERRED_PROVIDERS. Служба МБ задает заголовок со значениями, отображаемыми в следующей таблице при отправке структуры данных в драйвер минипорта для задания операций. Драйверы минипорта должны задать заголовок с одинаковыми значениями при отправке структуры данных в службу МБ.
Вложенный элемент заголовка | Ценность |
---|---|
Тип | NDIS_OBJECT_TYPE_DEFAULT |
Пересмотр | NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1 |
Размер | sizeof(NDIS_WWAN_PREFERRED_PROVIDERS) |
Дополнительные сведения об этих членах см. в NDIS_OBJECT_HEADER.
uStatus
Драйвер минипорта должен задать значение WWAN_STATUS_SUCCESS для незапрошенных событий (NDIS_STATUS_INDICATION::RequestId = 0). WWAN_STATUS_SUCCESS также устанавливается для успешного выполнения NDIS_WWAN_SET_PREFERRED_PROVIDERS.
В следующей таблице показаны другие возможные коды состояния ошибок (другие члены не должны обновляться мини-драйвером).
Ценность | Значение |
---|---|
WWAN_STATUS_PIN_REQUIRED | Для устройства требуется ввод ПИН-кода. |
WWAN_STATUS_READ_FAILURE | Считывание сведений с устройства или SIM-карты или обоих не удалось. Например, SIM-карта не предоставляет сведения о предпочитаемых поставщиках. |
WWAN_STATUS_BAD_SIM | Обнаружена плохая SIM-карта. |
WWAN_STATUS_SIM_NOT_INSERTED | SIM-карта не вставлена на устройство. |
WWAN_STATUS_NO_DEVICE_SUPPORT | Запрос не поддерживается. |
PreferredListHeader
Форматированный объект WWAN_LIST_HEADER, представляющий список предпочтительных поставщиков, включая количество поставщиков в списке.
Они указывают на список WWAN_PROVIDER2 с помощью структуры WWAN_LIST_HEADER. флаги WwanDataClass описывают предпочтения конкретной технологии доступа к данным и могут быть заданы в любом сочетании в собственном классе сотовой связи.
Ответ на набор запросов OID_WWAN_PREFERRED_PROVIDERS должен содержать нулевые элементы в PreferenceListHeader.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Доступно в Windows 7 и более поздних версиях Windows. |
заголовка | ndiswwan.h (включая Ndiswwan.h) |