Bewerken

Delen via


WWAN_REGISTRATION_PARAMS_INFO structure (wwan.h)

The WWAN_REGISTRATION_PARAMS_INFO structure represents parameters that an MB device uses during 5G registration requests. A host typically sends an OID_WWAN_REGISTER_PARAMS set request with a WWAN_REGISTRATION_PARAMS_INFO structure to configure a device with the desired registration parameters.

Syntax

typedef struct _WWAN_REGISTRATION_PARAMS_INFO {
  WWAN_MICO_MODE                MicoMode;
  WWAN_DRX_PARAMS               DRXParam;
  WWAN_LADN_IND_REQUEST         LADNInfo;
  WWAN_DEFAULT_PDU_SESSION_HINT DefaultPDUSessionHint;
  UINT32                        ReRegisterIfNeeded;
  GUID                          OSId;
  WWAN_LIST_HEADER              PreConfiguredNSSAIListHeader;
} WWAN_REGISTRATION_PARAMS_INFO, *PWWAN_REGISTRATION_PARAMS_INFO;

Members

MicoMode

A value from the WWAN_MICO_MODE enumeration that represents the Mobile Initiated Connection (MICO) mode requested by the host.

DRXParam

A value from the WWAN_DRX_PARAMS enumeration that represents the configuration of Discontinuous Reception (DRX) settings requested by the host.

LADNInfo

A value from the WWAN_LADN_IND_REQUEST enumeration that represents the Local Area Data Networks (LADN) information requested by the host.

DefaultPDUSessionHint

A value from the WWAN_DEFAULT_PDU_SESSION_HINT enumeration that represents a hint that the host will possibly establish the default protocol data unit (PDU) session immediately after the registration is complete. Since this depends on several policies, it may not happen.

ReRegisterIfNeeded

This is a forced re-registration indicator.

When this structure is used with OID_WWAN_REGISTER_PARAMS set requests:

  • If the value is 1 and the device is currently registered or in the middle of registration, the modem shall evaluate whether any of the registration parameters contained in this set request are different than those used in the previous registration request toward the network. If the parameters are different, the modem shall de-register from the network and re-register using the current registration parameters. All normal procedures related to de-registration and registration, including sending appropriate events at appropriate times, shall be performed.

  • A value of 0 indicates that forced re-registration is not requested.

  • This is a one-time indicator. The modem shall use this only once upon receiving this set request.

All other values are reserved.

OSId

A GUID that represents the OS Id. A value of 0 means MBIM_TLV_TYPE_OSID is not contained in the MBIM_CID_MS_REGISTRATION_PARAMS payload.

PreConfiguredNSSAIListHeader

A WWAN_LIST_HEADER object that represents a pre-configured Single Network Slice Selection Assistance Information (S-NSSAI). The host will send exactly one S-NSSAI if the modem has zero pre-configured default S-NSSAIs.

Remarks

The WWAN_REGISTRATION_PARAMS_INFO structure is used in OID_WWAN_REGISTER_PARAMS set and query requests and NDIS_STATUS_WWAN_REGISTER_PARAMS_STATE notifications.

Requirements

Requirement Value
Minimum supported client Windows 11
Minimum supported server Windows Server 2022
Header wwan.h

See also

OID_WWAN_REGISTER_PARAMS

NDIS_STATUS_WWAN_REGISTER_PARAMS_STATE

WWAN_MICO_MODE

WWAN_DRX_PARAMS

WWAN_LADN_IND_REQUEST

WWAN_DEFAULT_PDU_SESSION_HINT

WWAN_LIST_HEADER