OID_WWAN_PREFERRED_PROVIDERS

OID_WWAN_PREFERRED_PROVIDERS は、GSM ベースのデバイスの優先プロバイダーの一覧に関する情報を返します。 CDMA ベースのデバイスのミニポート ドライバーは、この OID をサポートする必要はありません。

ミニポート ドライバーは、set 要求と query 要求を非同期的に処理する必要があります。最初は元の要求に対して NDIS_STATUS_INDICATION_REQUIRED を返し、後で、set 要求または query 要求の完了に関係なく優先プロバイダリスト (PPL) に関する情報を提供するNDIS_WWAN_PREFERRED_PROVIDERS構造体を含む NDIS_STATUS_WWAN_PREFERRED_PROVIDERS状態通知を送信します。

解説

この OID の使用の詳細については、WWAN プロバイダー操作を参照してください。

query 要求を処理する場合、ミニポート ドライバーは加入者識別モジュール (SIM カード) にアクセスできますが、プロバイダー ネットワークにはアクセスできません。

ミニポート ドライバーは、set 要求を処理するときに、加入者識別モジュール (SIM カード) またはプロバイダー ネットワークにアクセスできます。

OID_WWAN_PREFERRED_PROVIDERS を処理する場合、ミニポート ドライバーは、一覧のエントリにタグを付けるために、WWAN_PROVIDER_STATE_PREFERRED または WWAN_PROVIDER_STATE_FORBIDDEN フラグのみを設定できます。 禁止されたプロバイダーが GSM ベースのデバイスの一覧に表示されない可能性があることに注意してください。

ミニポート ドライバーは、PreferredListHeader.ElementTypeメンバーをWwanStructProviderに設定する必要があります。 OID_WWAN_PREFERRED_PROVIDERS の set 要求に応答するときに、ミニポート ドライバーは PreferredListHeader.ElementCount メンバーを 0 に設定します。

set 要求の処理でデバイス上の PPL を上書きできるかどうかは、デバイスの機能、セルラー テクノロジ、ネットワーク プロバイダーのポリシーによって異なります。

ミニポート ドライバーが PPL の取得または設定をサポートしていない場合、NDIS_STATUS_NOT_SUPPORTED を返します。

要件

バージョン

Windows 7 以降のバージョンの Windows で使用できます。

ヘッダー

Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_WWAN_PREFERRED_PROVIDERS

NDIS_STATUS_WWAN_PREFERRED_PROVIDERS

WWAN プロバイダー操作