OID_WWAN_REGISTER_STATE selects a network provider to register with.
Miniport drivers must process set and query requests asynchronously, initially returning NDIS_STATUS_INDICATION_REQUIRED to the original request, and later sending an NDIS_STATUS_WWAN_REGISTER_STATE status notification containing an NDIS_WWAN_REGISTRATION_STATE structure to provide information about the registered network provider regardless of completing set or query requests.
Callers requesting to set the network provider to register with provide an NDIS_WWAN_SET_REGISTER_STATE structure to the miniport driver with the appropriate information.
For more information about using this OID, see WWAN Registration Operations.
Miniport drivers can access the provider network when processing query or set operations, but should not access the Subscriber Identity Module (SIM card).
The MB driver model supports two registration methods--automatic and manual. For CDMA-based networks, the MB driver model supports only automatic registration.
Devices supporting manual registration must set the WwanControlCaps member in WWAN_DEVICE_CAPS structure to WWAN_CTRL_CAPS_REG_MANUAL. Be aware that GSM-based devices must support manual registration.
If the registration state is automatic, miniport drivers must instruct their device to select a network provider based on the selection algorithm specific to the cellular technology and proceed with registration.
The semantics of RegisterAction values are defined as follows:
The WwanRegisterActionAutomatic flag is used by the MB Service to instruct the miniport driver to set the device to automatic register mode and let the device select the best provider network. The miniport driver must ignore ProviderId parameter. This setting is persistent across radio states (ON/OFF), and device power cycles, until it is explicitly change by the MB Service.
The WwanRegisterActionManual flag is used by the MB Service to instruct the miniport driver to register with the provider network identified by the ProviderId parameter. The ProviderId value shall come from the ProviderId member of WWAN_PROVIDER data structure of one of the visible providers. This setting is persistent across radio states (ON/OFF), and device power cycles, until it is explicitly changed by the MB Service.
Changing between the different RegisterAction values are allowed even if the device is currently registered to a provider. If the device need to deregister before switching between the Automatic and Manual registration modes, the miniport driver must ensure that the device is set to deregistration before setting to the new registration mode.
The Manual and Automatic registration mode only affects the network selection mode. The MB device should try to register to selected network whenever the radio is turned on.
Available in Windows 7 and later versions of Windows.
|Ntddndis.h (include Ndis.h)|