WWAN_SIGNAL_STATE_EXT構造体 (wwan.h)
WWAN_SIGNAL_STATE_EXT構造体は、MB デバイスのシグナル状態の拡張を表します。 Windows 10バージョン 1903 以降では、WWAN_SIGNAL_STATE_EXには、5G に固有の信号状態情報を含むWWAN_SIGNAL_STATE_EXT構造体の配列を含む、デバイスの信号状態に関する主要な情報が含まれています。
5G データ クラスのサポートの詳細については、「 MB 5G データ クラスのサポート」を参照してください。
構文
typedef struct _WWAN_SIGNAL_STATE_EXT {
ULONG RSRP;
ULONG RSRPThreshold;
ULONG SNR;
ULONG SNRThreshold;
ULONG DataClass;
} WWAN_SIGNAL_STATE_EXT, *PWWAN_SIGNAL_STATE_EXT;
メンバー
RSRP
-156 ~ -31 の範囲の基準信号受信電力 (RSRP) (1 dBm 単位)。 この情報を使用できない場合は、WWAN_RSRP_UNKNOWNを使用します。 次の表は、RSRP メンバーに範囲をマップする方法を示しています。
| 報告される値 | 測定数量値 (L3 SS_RSRP) | 測定数量値 (L1 SS-RSRP および CSI-RSRP) | ユニット |
|---|---|---|---|
| RSRP_0 | SS-RSRP-156< | 無効 | Dbm |
| RSRP_1 | -156≤ SS-RSRP-55< | 無効 | Dbm |
| RSRP_2 | -155≤ SS-RSRP-54< | 無効 | Dbm |
| RSRP_3 | -154≤ SS-RSRP-153< | 無効 | Dbm |
| RSRP_4 | -153≤ SS-RSRP-152< | 無効 | Dbm |
| RSRP_5 | -152≤ SS-RSRP-151< | 無効 | Dbm |
| ... | ... | ... | ... |
| RSRP_16 | -141≤ SS-RSRP-140< | 無効 | Dbm |
| RSRP_17 | -140≤ SS-RSRP-139< | RSRP-139< dBm | |
| RSRP_18 | -139≤ SS-RSRP-138< | -139≤ RSRP-138< dBm | |
| ... | ... | ... | ... |
| RSRP_111 | -46≤ SS-RSRP-45< | -46≤ RSRP-45< | Dbm |
| RSRP_112 | -45≤ SS-RSRP-44< | -45≤ RSRP | Dbm |
| RSRP_113 | -44≤ SS-RSRP-43< | 無効 | Dbm |
| RSRP_114 | -43≤ SS-RSRP-42< | 無効 | Dbm |
| RSRP_115 | -42≤ SS-RSRP-41< | 無効 | Dbm |
| RSRP_116 | -41≤ SS-RSRP-40< | 無効 | Dbm |
| RSRP_117 | -40≤ SS-RSRP-39< | 無効 | Dbm |
| RSRP_118 | -39≤ SS-RSRP-38< | 無効 | Dbm |
| RSRP_119 | -38≤ SS-RSRP-37< | 無効 | Dbm |
| RSRP_120 | -37≤ SS-RSRP-36< | 無効 | Dbm |
| RSRP_121 | -36≤ SS-RSRP-35< | 無効 | Dbm |
| RSRP_122 | -35≤ SS-RSRP-34< | 無効 | Dbm |
| RSRP_123 | -34≤ SS-RSRP-33< | 無効 | Dbm |
| RSRP_124 | -33≤ SS-RSRP-32< | 無効 | Dbm |
| RSRP_125 | -32≤ SS-RSRP-31< | 無効 | Dbm |
| RSRP_126 | -31≤ SS-RSRP | 無効 | Dbm |
| RSRP_127 | 無限大 | 無効 | Dbm |
このメンバーは、DataClass メンバーが WWAN_DATA_CLASS_LTE または WWAN_DATA_CLASS_5G_NSA/SA に設定されている場合にのみ有効です。 それ以外の場合は、 WWAN_RSRP_UNKNOWNを使用します。
RSRPThreshold
現在のしきい値 (しきい値単位 (1 dBm) で、ミニポート ドライバーが設定されている (または既定のしきい値が設定されていない場合)、ミニポート ドライバーがシグナル状態に関する更新プログラムを提供します。 ドライバーがしきい値ベースのレポートを実装していないことを示すには、WWAN_RSRP_DISABLEを指定します。 ミニポート ドライバーは、WWAN_RSRP_DEFAULTの MB サービスからの以前の要求に応答して、しきい値ユニットをこのメンバーに設定 する必要があります。
このメンバーは、DataClass メンバーが WWAN_DATA_CLASS_LTE または WWAN_DATA_CLASS_5G_NSA/SA に設定されている場合にのみ有効です。 それ以外の場合は、 WWAN_RSRP_DISABLEを使用します。
SNR
-23 ~ 40 の範囲の信号対ノイズ (SNR) 比 (0.5 dB 単位)。 この情報が利用できない場合は、 WWAN_SNR_UNKNOWN を使用します。 次の表は、範囲を SNR メンバーにマップする方法を示しています。
| 報告される値 | 測定数量の値 | ユニット |
|---|---|---|
| SNR_0 | SNR-23< | Db |
| SNR_1 | -23≤ SNR-22.5< | Db |
| SNR_2 | -22.5≤ SNR-22< | Db |
| SNR_3 | -22≤ SNR-21.5< | Db |
| SNR_4 | -21.5≤ SNR-21< | Db |
| ... | ... | ... |
| SNR_123 | 38≤ SNR<38.5 | Db |
| SNR_124 | 38.5≤ SNR<39 | Db |
| SNR_125 | 39≤ SNR<39.5 | Db |
| SNR_126 | 39.5≤ SNR<40 | Db |
| SNR_127 | 40≤ SNR | Db |
このメンバーは、DataClass メンバーが WWAN_DATA_CLASS_LTE または WWAN_DATA_CLASS_5G_NSA/SA に設定されている場合にのみ有効です。 それ以外の場合は、 WWAN_SNR_UNKNOWNを使用します。
SNRThreshold
現在のしきい値 (しきい値単位 (1 dBm) で、ミニポート ドライバーが設定されている (または既定のしきい値が設定されていない場合)、ミニポート ドライバーがシグナル状態に関する更新プログラムを提供します。 ドライバーがしきい値ベースのレポートを実装していないことを示すには、WWAN_SNR_DISABLEを指定します。 ミニポート ドライバーは、 WWAN_SNR_DEFAULTの MB サービスからの以前の要求に応答して、しきい値ユニットをこのメンバーに設定する必要があります。
このメンバーは、DataClass メンバーが WWAN_DATA_CLASS_LTE または WWAN_DATA_CLASS_5G_NSA/SA に設定されている場合にのみ有効です。 それ以外の場合は、 WWAN_SNR_DISABLEを使用します。
DataClass
パラメーターが有効なデータ クラスを示します。 WWAN_DATA_CLASS_LTEまたはWWAN_DATA_CLASS_5G_NSA/SA が設定されている場合にのみ、RSRP、RSRPThreshold、SNR、SNRThreshold メンバーが有効です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 バージョン 1903 |
| Header | wwan.h (Wwan.h を含む) |