Miniport drivers use the NDIS_STATUS_WWAN_HOME_PROVIDER notification to inform the MB Service about the completion of OID_WWAN_HOME_PROVIDER query requests.
Miniport drivers cannot use this notification to send unsolicited events.
This notification uses the NDIS_WWAN_HOME_PROVIDER structure.
Miniport drivers must comply with the following rules when responding to OID_WWAN_HOME_PROVIDER query requests:
GSM-Based Devices: The home provider name can be retrieved from the Subscriber Identity Module (SIM) using several methods, such as from the EFSPN elementary file in the SIM (EFSPN is defined in the 3GPP TS 31.102 under section Service Provider Name), or from the operator-specific extensions when the EFSPN is not provisioned. You should refer to the operator-specific requirements specifications for obtaining the home provider name, extracting MCC-MNC from IMSI, and performing a look up in the GSMA SE.13 database. Contact the operator when retrieving operator-specific home provider names if the EFSPN is not provisioned. If a SIM is not provisioned with a home provider name through EFSPN or any other mechanism, miniport drivers should set the provider name to NULL.
For details about a SIM card's file system, see the 3GPP TS 11.11 specification. If the provider identification is not provisioned in the Subscriber Identity Module (SIM card), miniport drivers should return WWAN_STATUS_READ_FAILURE.
CDMA-Based Devices: Returning the home provider name is mandatory. It is recommended that IHVs provide this information in their device as part of network personalization. If the provider identity is not available, miniport drivers for CDMA-based providers must set the Provider.ProviderId member of the NDIS_WWAN_HOME_PROVIDER structure to WWAN_CDMA_DEFAULT_PROVIDER_ID.
Miniport drivers must return this information when the device ready-state changes to WwanReadyStateInitialized and format all the members of the WWAN_PROVIDER structure, as appropriate.
Available in Windows 7 and later versions of Windows.
|Ntddndis.h (include Ndis.h)|