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
1 dBm 単位で、-156 ~ -31 の範囲の基準信号受信電力 (RSRP)。 この情報が使用できない場合は、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)、しきい値単位 (1 dBm)、ミニポート ドライバーが信号状態に関する更新プログラムを提供する場合は、既定のしきい値です。 ドライバーがしきい値ベースのレポートを実装していないことを示す WWAN_RSRP_DISABLE を指定します。 ミニポート ドライバーは、WWAN_RSRP_DEFAULTの MB サービスからの以前の要求に応答してしきい値単位をこのメンバーに設定する必要があります。
このメンバーは、DataClass メンバーが WWAN_DATA_CLASS_LTE または WWAN_DATA_CLASS_5G_NSA/SAに設定されている場合にのみ有効です。 それ以外の場合は、WWAN_RSRP_DISABLEを使用します。
SNR
信号対雑音(SNR)比は、-23 から40までの範囲で、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)、しきい値単位 (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 |
| ヘッダー | wwan.h (Wwan.h を含む) |