OID_WWAN_PREFERRED_MULTICARRIER_PROVIDERS

OID_WWAN_PREFERRED_MULTICARRIER_PROVIDERS is used to set or query the list of preferred multi-carrier network providers. Multi-carrier providers are ones that can be set as home providers.

Both set and query requests are supported. Miniport drivers must process set and query requests asynchronously, initially returning NDIS_STATUS_INDICATION_REQUIRED to the original request, and later sending a NDIS_STATUS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS status notification containing an NDIS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS structure.

Miniport drivers should set the PreferredListHeader.ElementType member to WwanStructProvider2 and the PreferredListHeader.ElementCount member to the number of providers in the list when responding to OID_WWAN_PREFERRED_PROVIDERS query requests. The multi-carrier providers returned in a query must be able to be set as the home provider at the time the preferred multi-carrier list is returned to the service.

Miniport drivers should set the PreferredListHeader.ElementType member to WwanStructProvider2 and the PreferredListHeader.ElementCount member to 0 when responding to OID_WWAN_PREFERRED_PROVIDERS set requests.

On error miniports should set the uStatus member of NDIS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS structure with the failure status and PreferredListHeader.ElementCount to 0 and PreferredLIstHeader.ElementType to WwanStructProvider2.

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

Requirements

Version

Versions: Supported in Windows 8 and later versions of Windows.

Header

Ntddndis.h (include Ndis.h)

See also

NDIS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS

NDIS_STATUS_WWAN_PREFERRED_MULTICARRIER_PROVIDERS

MB Provider Operations