структура 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)

См. также раздел

NDIS_OBJECT_HEADER

WWAN_REGISTRATION_STATE