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(참조 신호 수신 전원)(1dBm 단위)입니다. 이 정보를 사용할 수 없는 경우 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

미니포트 드라이버가 설정된 임계값 단위(1dBm)의 현재 임계값(또는 설정되지 않은 경우 기본 임계값)입니다. 여기서 미니포트 드라이버는 신호 상태에 대한 업데이트를 제공합니다. 드라이버가 임계값 기반 보고를 구현하지 않음을 나타내려면 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.5dB 단위)입니다. 이 정보를 사용할 수 없는 경우 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

미니포트 드라이버가 설정된 임계값 단위(1dBm)의 현재 임계값(또는 설정되지 않은 경우 기본 임계값)입니다. 여기서 미니포트 드라이버는 신호 상태에 대한 업데이트를 제공합니다. 드라이버가 임계값 기반 보고를 구현하지 않음을 나타내려면 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 포함)

추가 정보

WWAN_SIGNAL_STATE