структура NDIS_WWAN_REGISTRATION_STATE (ndiswwan.h)
Структура NDIS_WWAN_REGISTRATION_STATE представляет состояние регистрации устройства в МБ.
Синтаксис
typedef struct _NDIS_WWAN_REGISTRATION_STATE {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_REGISTRATION_STATE RegistrationState;
} NDIS_WWAN_REGISTRATION_STATE, *PNDIS_WWAN_REGISTRATION_STATE;
Члены
Header
Заголовок со сведениями о типе, редакции и размере структуры NDIS_WWAN_REGISTRATION_STATE. Служба MB задает заголовок со значениями, приведенными в следующей таблице, при отправке структуры данных в драйвер мини-порта для операций установки . Драйверы минипорта должны задавать заголовок с одинаковыми значениями при отправке структуры данных в службу МБ.
| Подмембер заголовка | Значение |
|---|---|
| Тип | NDIS_OBJECT_TYPE_DEFAULT |
| Редакция | Windows 10 версии 1903 для драйверов miniport, поддерживающих устройство 5G, следует задать для этого параметра значение NDIS_WWAN_REGISTRATION_STATE_REVISION_3. Windows 8 драйверам минипорта следует задать для этого параметра значение NDIS_WWAN_REGISTRATION_STATE_REVISION_2. Драйверы windows 7 miniport должны установить для этого параметра значение NDIS_WWAN_REGISTRATION_STATE_REVISION_1. |
| Размер | sizeof(NDIS_WWAN_REGISTRATION_STATE) |
Дополнительные сведения об этих элементах см. в разделе NDIS_OBJECT_HEADER.
uStatus
Драйвер мини-порта должен задать для этого параметра значение WWAN_STATUS_SUCCESS для нежелательных событий (NDIS_STATUS_INDICATION::RequestId = 0). WWAN_STATUS_SUCCESS также настроено для успешного выполнения NDIS_WWAN_SET_REGISTER_STATE.
В следующей таблице показаны другие возможные коды состояния ошибок.
| Значение | Значение |
|---|---|
| WWAN_STATUS_PIN_REQUIRED | Для устройства требуется ввод значения ПИН-кода. |
| WWAN_STATUS_FAILURE | Не удается получить состояние регистрации. |
| WWAN_STATUS_NOT_INITIALIZED | Операция завершилась сбоем, так как устройство находится в процессе инициализации. Повторите операцию после того, как состояние готовности устройства изменится на WwanReadyStateInitialized. |
| WWAN_STATUS_BAD_SIM | Операция завершилась сбоем, так как обнаружена неправильная КАРТА SIM-карты. |
| WWAN_STATUS_SIM_NOT_INSERTED | Операция завершилась сбоем, так как карта SIM-карты не была полностью вставлена в устройство. |
Драйверы минипорта могут возвращать следующие коды ошибок (в дополнение к перечисленным выше) только в случае сбоя операции активации PDP.
| Значение | Значение |
|---|---|
| WWAN_STATUS_FAILURE | Не удается задать состояние регистрации. Дополнительные сведения указаны в uNwError . Для других кодов ошибок uNwError должно иметь значение 0. |
| WWAN_STATUS_NO_DEVICE_SUPPORT | Устройства на основе CDMA должны возвращать этот код ошибки, если запрос на регистрацию набора предназначен для ручной регистрации. |
| WWAN_STATUS_SERVICE_NOT_ACTIVATED | Сбой активации службы. Срок действия подписки истек. Устройство не разрешает настройку состояния регистрации. |
| WWAN_STATUS_PROVIDER_NOT_VISIBLE | Поставщик не отображается для регистрации. Это предназначено для ручной регистрации. |
| WWAN_STATUS_INVALID_PARAMETERS | Если запрос выполняется вручную для регистрации запрещенного поставщика. |
| WWAN_STATUS_BUSY | Устройство занято и не может изменить режим регистрации. Этот сценарий может возникнуть, если устройство не разрешает изменять режим регистрации при активации контекста PDP. |
RegistrationState
Отформатированный объект WWAN_REGISTRATION_STATE , представляющий состояние регистрации устройства в МБ.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 7 и более поздних версиях Windows. |
| Верхняя часть | ndiswwan.h (включая Ndiswwan.h) |