NDIS_STATUS_WWAN_PIN_INFO
Водители мини-порта используют уведомление NDIS_STATUS_WWAN_PIN_INFO для ответа на запрос OID и задания запросов OID_WWAN_PIN.
Водители мини-порта не могут использовать это уведомление для отправки нежелательных событий.
В этом уведомлении используется структура NDIS_WWAN_PIN_INFO .
Комментарии
Драйверы мини-порта должны возвращать сведения о пин-коде, который устройство МБ ожидает в ответ на запрос запроса. Водители минипорта должны возвращать уведомление о состоянии, заполненное, как описано в разделах ниже, в ответ на заданный запрос.
Ответ на запросы WwanPinOperationEnter
Когда водители мини-порта используют уведомление NDIS_STATUS_WWAN_PIN_INFO для ответа на запросы WwanPinOperationEnter , они должны реализовать следующие процедуры:
Для успешного выполнения запросов WwanPinOperationEnter , когда устройству МБ больше не требуется ПИН-код, драйверы мини-порта должны задать для uStatus значение WWAN_STATUS_SUCCESS, а PinType — WwanPinTypeNone.
Для неудачных запросов WwanPinOperationEnter драйверы мини-порта должны задать для uStatus значение WWAN_STATUS_FAILURE и включить применимые данные в соответствии со следующими сведениями:
ПИН-код отключен или ПИН-код не ожидается. Для запросов на набор WwanPinOperationEnter , если соответствующий ПИН-код отключен или в настоящее время не ожидается устройством с МБ, драйверы мини-порта должны задать для PinType значение WwanPinTypeNone. Все остальные элементы игнорируются.
ПИН-код не поддерживается. Если указанный ПИН-код не поддерживается устройством с мб, драйверы мини-порта должны задать для uStatus значение WWAN_STATUS_NO_DEVICE_SUPPORT.
Повторный ввод ПИН-кода. В этом режиме устройство с МБ требует повторного ввода ПИН-кода, так как значение AttemptsRemaining по-прежнему не равно нулю для этого конкретного типа ПИН-кода. Драйверы miniport должны иметь то же значение , что и для PinType в NDIS_WWAN_SET_PIN.
Блокировка ПИН-кода. Пин-код блокируется, если значение AttemptsRemaining равно нулю . Если операция разблокировки ПИН-кода недоступна, драйверы мини-порта должны задать для uStatus значение WWAN_STATUS_FAILURE, а PinType — WwanPinTypeNone. Все остальные элементы игнорируются.
Примечание Если устройство в МБ поддерживает операции разблокировки ПИН-кода, драйверы мини-порта должны следовать шагу Разблокировка ПИН-кода, чтобы ответить на запрос.
Разблокировка ПИН-кода. ПИН-код блокируется, если значение AttemptsRemaining равно нулю . Чтобы разблокировать ПИН-код, устройство МБ может запросить соответствующий ключ разблокировки ПИН-кода (PUK), если применимо. В этом случае драйверы минипорта должны задать для PinType соответствующийPUK-файлWwanPinType Xxx с соответствующими сведениями.
Заблокировано PUK. Если количество неудачных проб превышает предустановленное значение для ввода PUK WwanPinTypeXxx, PUK блокируется. Драйверы минипорта должны сообщить об этом, задав для uStatus значение WWAN_STATUS_FAILURE, а Для PinType — значение WwanPinTypeNone. В случае блокировки PUK1 драйверы минипорта должны отправить NDIS_STATUS_WWAN_READY_INFO с параметром ReadyState , равным WwanReadyStateBadSim.
Реагирование на запросы WwanPinOperationEnable, WwanPinOperationDisable или WwanPinOperationChange
Когда драйверы мини-порта используют уведомление NDIS_STATUS_WWAN_PIN_INFO для ответа на запросы WwanPinOperationEnable, WwanPinOperationDisable и WwanPinOperationChange, они должны реализовать следующие операции:
Для успешных запросов драйверы мини-порта должны задать для uStatus значение WWAN_STATUS_SUCCESS. Сведения о других членах в WWAN_PIN_INFO см. в следующих случаях.
Драйверы минипорта должны настроить uStatus на WWAN_STATUS_SUCCESS для операций включения ПИН-кода и отключения ПИН-кода, если ПИН-код уже находится в запрошенном состоянии. Драйверы мини-порта должны задать для Параметра PinType значение WwanPinTypeNone. Другие элементы игнорируются.
При изменении режима ПИН-кода с отключенного на включено состояние ПИН-кода должно быть WwanPinStateNone.
Если пин-код 1 включен, состояние ПИН-кода должно стать WwanPinStateEnter при цикле питания к устройству с МБ.
Для всех остальных ПИН-кодов состояние ПИН-кода может измениться с WwanPinStateNone на WwanPinStateEnter в зависимости от условий устройства в МБ.
ПИН-код не поддерживается. Если операция ПИН-кода не поддерживается устройством с мб, драйверы мини-порта должны задать для uStatus значение WWAN_STATUS_NO_DEVICE_SUPPORT. Например, включение и отключение ПИН-кода 2 обычно не поддерживается устройствами с мб, поэтому должен быть возвращен приведенный выше код ошибки. Все остальные элементы игнорируются.
Необходимо ввести ПИН-код. Если операция с ПИН-кодом требует ввода ПИН-кода, драйверы мини-порта должны задать для uStatus значение WWAN_STATUS_PIN_REQUIRED, а pinType — значение WwanPinTypeXxx. Другие элементы игнорируются.
Операция изменения ПИН-кода. Если устройство в МБ ограничивает изменение значения ПИН-кода только в том случае, если оно находится в состоянии "Включено", запрос на изменение отключенного состояния должен быть возвращен с WWAN_STATUS_PIN_DISABLED.
Повторное выполнение ПИН-кода. При сбое драйверы мини-порта должны задать для uStatus значение WWAN_STATUS_FAILURE, а PinType — то же значение, что указано в NDIS_WWAN_SET_PIN. Другие члены игнорируются, за исключением AttemptsRemaining. Это может произойти при вводе неправильного ПИН-кода.
Блокировка ПИН-кода. ПИН-код блокируется, если число попытокRemaining равно нулю . Если операция разблокировки ПИН-кода недоступна, драйверы мини-порта должны задать для uStatus значение WWAN_STATUS_FAILURE, а PinType — WwanPinTypeNone. Для элемента AttemptsRemaining должно быть задано значение 0, а все остальные элементы игнорируются.
Примечание Если устройство в МБ поддерживает операции разблокировки ПИН-кода, драйверы мини-порта должны следовать шагу Разблокировка ПИН-кода, чтобы ответить на запрос.
Разблокировка ПИН-кода. ПИН-код блокируется, если значение AttemptsRemaining равно нулю . Чтобы разблокировать ПИН-код, устройство МБ может запросить соответствующий PUK, если это применимо. В этом случае драйверы miniport должны задать для uStatus значение WWAN_STATUS_FAILURE, PinType — соответствующий PUK WwanPinTypeXxx, PinState — WwanPinStateEnter, а AttemptsRemaining — допустимое число попыток ввода допустимого PUK.
Если блокировка ПИН-кода приводит к блокировке устройства в МБ или SIM-карты, драйверы мини-порта должны отправить уведомление о событии с параметром ReadyState , установленным как WwanReadyStateDeviceLocked.
Если во время блокировки ПИН-кода 1 имеется активный контекст PDP, драйверы мини-порта должны отключить контекст PDP и отправить в операционную систему уведомления об изменении состояния PDP и деактивации PDP.
Требования
Версия |
Доступно в Windows 7 и более поздних версиях Windows. |
Заголовок |
Ndis.h |