NDIS_WWAN_PREFERRED_PROVIDERS 構造体 (ndiswwan.h)

NDIS_WWAN_PREFERRED_PROVIDERS構造体は、リスト内のプロバイダーの数を含む優先プロバイダーの一覧を表します。

構文

typedef struct _NDIS_WWAN_PREFERRED_PROVIDERS {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_LIST_HEADER   PreferredListHeader;
} NDIS_WWAN_PREFERRED_PROVIDERS, *PNDIS_WWAN_PREFERRED_PROVIDERS;

メンバー

Header

NDIS_WWAN_PREFERRED_PROVIDERS構造体に関する型、リビジョン、およびサイズ情報を含むヘッダー。 MB サービスは、設定された操作のミニポート ドライバーにデータ構造を送信するときに、次の表に示す値でヘッダーを 設定 します。 ミニポート ドライバーは、MB サービスにデータ構造を送信するときに、同じ値を持つヘッダーを設定する必要があります。

ヘッダー サブメンバー
NDIS_OBJECT_TYPE_DEFAULT
リビジョン NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1
サイズ sizeof(NDIS_WWAN_PREFERRED_PROVIDERS)
 

これらのメンバーの詳細については、「 NDIS_OBJECT_HEADER」を参照してください。

uStatus

ミニポート ドライバーは、要求されていないイベントのWWAN_STATUS_SUCCESSにこれを設定する必要があります (NDIS_STATUS_INDICATION::RequestId = 0)。 WWAN_STATUS_SUCCESSは、NDIS_WWAN_SET_PREFERRED_PROVIDERSの正常な実行にも設定されます。

次の表は、その他の考えられるエラー状態コードを示しています (他のメンバーはミニポート ドライバーによって更新する必要はありません)。

意味
WWAN_STATUS_PIN_REQUIRED デバイスには PIN 値の入力が必要です。
WWAN_STATUS_READ_FAILURE デバイスまたは SIM カード、またはその両方から情報を読み取れませんでした。 たとえば、SIM カードには、推奨されるプロバイダー情報がプロビジョニングされていません。
WWAN_STATUS_BAD_SIM 無効な SIM が検出されました。
WWAN_STATUS_SIM_NOT_INSERTED SIM がデバイスに挿入されていません。
WWAN_STATUS_NO_DEVICE_SUPPORT set 要求はサポートされていません。

PreferredListHeader

リスト内のプロバイダーの数など、優先プロバイダーの一覧を表す書式設定された WWAN_LIST_HEADER オブジェクト。

これらは、WWAN_LIST_HEADER構造体を使用して WWAN_PROVIDER2 の一覧を指します。 WwanDataClass フラグは、特定のデータ アクセス テクノロジの優先順位を表し、独自の携帯ネットワーク クラス内の任意の組み合わせに設定できます。

OID_WWAN_PREFERRED_PROVIDERS要求を 設定 するための応答には、 PreferenceListHeader に 0 個の要素が含まれている必要があります。

要件

要件
サポートされている最小のクライアント Windows 7 以降のバージョンの Windows で使用できます。
Header ndiswwan.h (Ndiswwan.h を含む)

こちらもご覧ください

NDIS_OBJECT_HEADER

WWAN_LIST_HEADER