OID_WWAN_VISIBLE_PROVIDERS
OID_WWAN_VISIBLE_PROVIDERS は、MB デバイスの範囲内で現在表示されているネットワーク プロバイダーの一覧を返します。
set 要求はサポートされていません。
ミニポート ドライバーは、query 要求を非同期的に処理する必要があります。これは最初に元の要求に対して NDIS_STATUS_INDICATION_REQUIRED を返し、後で query 要求完了時に表示されるネットワーク プロバイダーに関する情報を提供する NDIS_WWAN_VISIBLE_PROVIDERS 構造体を含む NDIS_STATUS_WWAN_VISIBLE_PROVIDERS 状態通知を送信します。
query 要求では、NDIS_WWAN_GET_VISIBLE_PROVIDERS 構造体を入力として指定します 。 WWAN_GET_VISIBLE_PROVIDERS の Action メンバーが WWAN_GET_VISIBLE_PROVIDERS_ALL に設定されている場合、ミニポートは表示されているすべてのプロバイダーを返します。 WWAN_GET_VISIBLE_PROVIDERS の Action メンバーが WWAN_GET_VISIBLE_PROVIDERS_MULTICARRIER に設定されている場合、ミニポートは、ホーム プロバイダーとして設定できる可視の複数キャリア プロバイダーのみを返します。
デバイスによって返される表示されるプロバイダーの一覧には、それぞれのプロバイダーに対するプロバイダー状態が正しく設定されている必要があります。 例えば、マルチキャリア優先プロバイダーには WWAN_PROVIDER_STATE_PREFERRED_MULTICARRIER というタグを付け、現在のホームプロバイダーには WWAN_PROVIDER_STATE_HOME というタグを付け、現在登録されているプロバイダーには WWAN_PROVIDER_STATE_REGISTERED というタグを付ける必要があります。
使用可能な場合、WWAN_PROVIDER2 構造体の Rssi メンバーと ErrorRate メンバーを設定する必要があります。
解説
この OID の使用の詳細については、WWAN プロバイダー操作を参照してください。
query 操作を処理する場合、ミニポート ドライバーは加入者識別モジュール (SIM カード) にアクセスできますが、プロバイダー ネットワークにはアクセスできません。
ミニポート ドライバーは、VisibleListHeader.ElementType メンバーを WwanStructProvider に設定する必要があります。
CDMA ベースのネットワークでは、優先ローミング リスト (PRL) のいずれかのネットワークが現在表示されている場合、ミニポート ドライバーはホーム プロバイダーのみを返す必要があります。 GSM ベースのネットワークの場合、表示されるプロバイダーの一覧に複数のプロバイダーが存在する可能性があります。
接続中に表示されるプロバイダーのスキャンをサポートしていないデバイスは、NDIS_WWAN_VISIBLE_PROVIDERS 構造体の uStatus メンバーで WWAN_STATUS_BUSY エラー値を返します。
GSM ベースと CDMA ベースのデバイスはどちらも、登録モードの間に表示されるプロバイダーのスキャンをサポートする必要があります。 ただし、ミニポート ドライバーは、パケット データ プロトコル (PDP) コンテキストがアクティブ (例えば、デバイスがプロバイダーのネットワークに接続されている) な場合、表示されるプロバイダーのスキャンをサポートする必要はありません。
要件
バージョン |
Windows 7 以降のバージョンの Windows で使用できます。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |