OID_WWAN_VISIBLE_PROVIDERS

OID_WWAN_VISIBLE_PROVIDERS returns a list of network providers currently visible within the MB device's range.

Set requests are not supported.

Miniport drivers must process query requests asynchronously, initially returning NDIS_STATUS_INDICATION_REQUIRED to the original request, and later sending an NDIS_STATUS_WWAN_VISIBLE_PROVIDERS status notification containing an NDIS_WWAN_VISIBLE_PROVIDERS structure to provide information about visible network providers when completing query requests.

Query requests specify NDIS_WWAN_GET_VISIBLE_PROVIDERS structure as input. When the Action member in WWAN_GET_VISIBLE_PROVIDERS is set to WWAN_GET_VISIBLE_PROVIDERS_ALL the miniport should return all visible providers. When the Action member in WWAN_GET_VISIBLE_PROVIDERS is set to WWAN_GET_VISIBLE_PROVIDERS_MULTICARRIER the miniport should only return visible multi-carrier providers that can be set as the home provider.

The visible provider list returned by the device should have the provider state set correctly for each of the providers. For example, the multicarrier preferred providers should be tagged as WWAN_PROVIDER_STATE_PREFERRED_MULTICARRIER, the current home provider if any should be tagged as WWAN_PROVIDER_STATE_HOME, The current registered provider if any should be tagged as WWAN_PROVIDER_STATE_REGISTERED.

The Rssi and ErrorRate members of WWAN_PROVIDER2 structure should be set if available.

Remarks

For more information about using this OID, see WWAN Provider Operations.

Miniport drivers can access the Subscriber Identity Module (SIM card) when processing query operations, but should not access the provider network.

Miniport drivers should set the VisibleListHeader.ElementType member to WwanStructProvider.

For CDMA-based networks, miniport driver should return only the home provider, if any of the networks in the Preferred Roaming List (PRL) is currently visible. For GSM-based networks, more than one provider may be present in the visible provider list.

Devices that do not support scanning for visible providers while connected should return the WWAN_STATUS_BUSY error value in the uStatus member of the NDIS_WWAN_VISIBLE_PROVIDERS structure.

Both GSM-based and CDMA-based devices must support scanning for visible providers while in registered mode. However, miniport drivers are not required to support scanning for visible provider while a Packet Data Protocol (PDP) context is active (for example, the device is connected to the provider's network).

Requirements

See also

NDIS_WWAN_VISIBLE_PROVIDERS

NDIS_STATUS_WWAN_VISIBLE_PROVIDERS

WWAN Provider Operations