OID_WWAN_VISIBLE_PROVIDERS
OID_WWAN_VISIBLE_PROVIDERS возвращает список сетевых поставщиков, которые в настоящее время отображаются в диапазоне мб устройства.
Запросы на набор не поддерживаются.
Драйверы мини-портов должны асинхронно обрабатывать запросы, изначально возвращая NDIS_STATUS_INDICATION_REQUIRED в исходный запрос, а затем отправляя уведомление о состоянии NDIS_STATUS_WWAN_VISIBLE_PROVIDERS , содержащее структуру NDIS_WWAN_VISIBLE_PROVIDERS для предоставления сведений о видимых сетевых поставщиках при выполнении запросов.
Запросы указывают NDIS_WWAN_GET_VISIBLE_PROVIDERS структуру в качестве входных данных. Если для элемента Action в WWAN_GET_VISIBLE_PROVIDERS задано значение WWAN_GET_VISIBLE_PROVIDERS_ALL мини-порт должен возвращать все видимые поставщики. Если для элемента Action в WWAN_GET_VISIBLE_PROVIDERS задано значение WWAN_GET_VISIBLE_PROVIDERS_MULTICARRIER мини-порт должен возвращать только видимых поставщиков с несколькими операторами, которые можно задать в качестве домашнего поставщика.
В видимом списке поставщиков, возвращаемом устройством, должно быть правильно задано состояние поставщика для каждого из поставщиков. Например, предпочитаемые поставщики с несколькими носителями должны быть помечены как WWAN_PROVIDER_STATE_PREFERRED_MULTICARRIER, текущий домашний поставщик, если таковой должен быть помечен как WWAN_PROVIDER_STATE_HOME, текущий зарегистрированный поставщик, если таковой должен быть помечен как WWAN_PROVIDER_STATE_REGISTERED.
При наличии необходимо задать элементы Rssi и ErrorRate структуры WWAN_PROVIDER2.
Комментарии
Дополнительные сведения об использовании этого объекта OID см. в разделе Операции поставщика WWAN.
Драйверы минипорта могут обращаться к модулю удостоверений подписчика (SIM-карта) при обработке операций запросов, но не должны обращаться к сети поставщика.
Драйверы Miniport должны задать для элемента VisibleListHeader.ElementType значение WwanStructProvider.
Для сетей на основе CDMA драйвер мини-порта должен возвращать только домашнего поставщика, если какая-либо из сетей в списке предпочтительных роумингов (PRL) в настоящее время видна. Для сетей на основе GSM в видимом списке поставщиков может присутствовать несколько поставщиков.
Устройства, которые не поддерживают проверку видимых поставщиков при подключении, должны возвращать значение ошибки WWAN_STATUS_BUSY в элементе uStatus структуры NDIS_WWAN_VISIBLE_PROVIDERS.
Устройства на основе GSM и CDMA должны поддерживать сканирование видимых поставщиков в зарегистрированном режиме. Однако драйверы мини-порта не требуются для поддержки проверки на наличие видимого поставщика при активном контексте протокола пакетных данных (PDP) (например, устройство подключено к сети поставщика).
Требования
Версия |
Доступно в Windows 7 и более поздних версиях Windows. |
Заголовок |
Ntddndis.h (включая Ndis.h) |