OID_WWAN_READY_INFO
OID_WWAN_READY_INFO возвращает состояние готовности устройства, которое включает модуль идентификации подписчика (SIM-карта). Обычно это происходит в начале любого сеанса.
Запросы на настройку не поддерживаются.
Узел может запрашивать состояние готовности из активного слота SIM-карты или неактивного слота SIM-карты на устройстве, если устройство поддерживает два слота SIM-карты. Полезные данные этого OID содержат структуру NDIS_WWAN_QUERY_READY_INFO , которая, в свою очередь, содержит структуру WWAN_QUERY_READY_INFO , указывающую идентификатор слота UICC.
Драйверы минипорта должны обрабатывать запросы асинхронно, сначала возвращая NDIS_STATUS_INDICATION_REQUIRED в исходный запрос, а затем отправляя уведомление о состоянии NDIS_STATUS_WWAN_READY_INFO , содержащее структуру NDIS_WWAN_READY_INFO , указывающую состояние готовности устройства в МБ при выполнении запросов.
Комментарии
Дополнительные сведения об использовании этого OID см. в разделе Готовность устройства в МБ.
Драйверы минипорта могут получать доступ к памяти устройства или SIM-карта при обработке операций запроса, но не должны обращаться к сети поставщика.
Драйверы мини-порта должны дождаться очистки ПИН-кода (при необходимости), а затем прочитать идентификатор и номера телефонов подписчика, а затем задать для элемента ReadyInfo.ReadyState структуры NDIS_WWAN_READY_INFO значение WwanReadyStateInitialized.
Драйверы минипорта никогда не должны завершаться ошибкой OID_WWAN_READY_INFO и всегда должны возвращать правильное состояние готовности устройства.
Драйверы минипорта должны всегда уведомлять службу MB при изменении состояния готовности устройства.
Чтобы обеспечить удобство работы с пользователем, драйверы мини-порта должны выполнить следующие действия:
Если PIN-код 1 заблокирован, драйверы мини-порта должны сначала отправить уведомление о событии готовности, а для свойства ReadyInfo.ReadyState задано значение WwanReadyStateDeviceLocked. Затем служба MB отправляет драйверу мини-порта запрос на набор OID OID_WWAN_PIN. После разблокировки устройства драйвер мини-порта должен отправить еще одно уведомление о событии готовности с параметром ReadyInfo.ReadyState , равным WwanReadyStateInitialized. Пока ПИН-код 1 не будет успешно разблокирован, драйверы мини-порта не должны изменять состояние готовности устройства на WwanReadyStateInitialized.
Драйверы минипорта должны сначала отправить уведомление о событии с параметром ReadyInfo.ReadyState, установленным в WwanReadyStateSimNotInserted, когда служба МБ загружает драйвер мини-порта, если sim-карта отсутствует карта, как это может быть в случае с устройствами, которые позволяют вставлять или удалять SIM-карты. Если устройство может обнаруживать горячую вставку SIM-карты карта, драйвер мини-порта должен отправить еще одно уведомление о событии с параметром ReadyInfo.ReadyState, для которого задано значение WwanReadyStateInitialized, когда пользователь вставляет SIM-карту.
Устройства, которые имеют возможность обнаруживать состояние активации службы, должны задать для Свойства ReadyInfo.ReadyState значение WwanReadyStateNotActivated. Кроме того, если драйвер минипорта поддерживает активацию службы, драйвер мини-порта получит запрос на набор OID OID_WWAN_SERVICE_ACTIVATION. После успешного завершения активации службы драйверы мини-порта должны отправить еще одно уведомление о событии, если для Свойства ReadyInfo.ReadyState задано значение WwanReadyStateInitialized.
Драйверы минипорта, для которых требуется определенная версия встроенного ПО, должны обеспечивать доступность правильной версии встроенного ПО. Если версия встроенного ПО недоступна, драйвер мини-порта должен завершить транзакцию уведомления о событиях, задав для параметра ReadyInfo.ReadyState значение WwanReadyStateFailure.
Требования
Версия: доступно в Windows 7 и более поздних версиях Windows.
Заголовок: Ntddndis.h (включая Ndis.h)