OID_WWAN_PREFERRED_PROVIDERS returns information about the list of preferred providers for GSM-based devices. Miniport drivers of CDMA-based devices do not need to support this OID.
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_PREFERRED_PROVIDERS status notification containing an NDIS_WWAN_PREFERRED_PROVIDERS structure to provide information about the Preferred Provider List (PPL) regardless of completing set or query requests.
For more information about using this OID, see WWAN Provider Operations.
Miniport drivers can access the Subscriber Identity Module (SIM card) when processing query requests, but should not access the provider network.
Miniport drivers can access the Subscriber Identity Module (SIM card) or the provider network, when processing set requests.
When processing OID_WWAN_PREFERRED_PROVIDERS, miniport drivers may set only the WWAN_PROVIDER_STATE_PREFERRED or WWAN_PROVIDER_STATE_FORBIDDEN flags to tag the list entries. Be aware that forbidden providers might not appear in the list for GSM-based devices.
Miniport driverrs should set the PreferredListHeader.ElementType member to WwanStructProvider. The miniport driver should set the PreferredListHeader.ElementCount member to 0 when responding to OID_WWAN_PREFERRED_PROVIDERS set requests.
Whether the PPL on the device can be overwritten or not when processing set requests depends on the device capability, the cellular technology, and/or the network provider's policy.
Miniport drivers should return NDIS_STATUS_NOT_SUPPORTED if they do not support returning or setting the PPL.
|Available in Windows 7 and later versions of Windows.|