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.
|Versions: Supported in Windows 8 and later versions of Windows.|
- MB Provider Operations