структура 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. Служба МБ задает заголовок со значениями, отображаемыми в следующей таблице при отправке структуры данных в драйвер минипорта для задания операций. Драйверы минипорта должны задать заголовок с одинаковыми значениями при отправке структуры данных в службу МБ.
| Вложенный элемент заголовка | Ценность |
|---|---|
| Тип | NDIS_OBJECT_TYPE_DEFAULT |
| Пересмотр | Драйверы мини-порта Windows 10 версии 1903, поддерживающие устройство 5G, должны задать для этого значение NDIS_WWAN_REGISTRATION_STATE_REVISION_3. Драйверы мини-порта Windows 8 должны задать для этого значение NDIS_WWAN_REGISTRATION_STATE_REVISION_2. Драйверы мини-порта Windows 7 должны задать для этого значение 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, представляющий состояние регистрации устройства MB.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows 7 и более поздних версиях Windows. |
| заголовка | ndiswwan.h (включая Ndiswwan.h) |