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 в качестве входных данных. Если для элемента WWAN_GET_VISIBLE_PROVIDERS действия действие задано значение WWAN_GET_VISIBLE_PROVIDERS_ALL минипорт должен возвращать все видимые поставщики. Если для элемента 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-карта) при обработке операций запроса, но не должны обращаться к сети поставщика.
Драйверы минипорта должны задать элемент VisibleListHeader.ElementType для WwanStructProvider.
Для сетей на основе CDMA минипорт должен возвращать только домашний поставщик, если в настоящее время отображается любой из сетей в списке предпочитаемых роумингов (PRL). Для сетей на основе GSM несколько поставщиков могут присутствовать в видимом списке поставщиков.
Устройства, которые не поддерживают сканирование видимых поставщиков во время подключения, должны возвращать значение ошибки WWAN_STATUS_BUSY в элементе uStatus структуры NDIS_WWAN_VISIBLE_PROVIDERS.
Устройства на основе GSM и CDMA должны поддерживать сканирование видимых поставщиков в зарегистрированном режиме. Однако минипорт-драйверы не требуются для поддержки сканирования видимого поставщика, пока контекст ПРОТОКОЛА данных пакетов (PDP) активен (например, устройство подключено к сети поставщика).
Требования
Версия |
Доступно в Windows 7 и более поздних версиях Windows. |
Заголовок |
Ntddndis.h (include Ndis.h) |