IMbnSignal::GetSignalStrength 메서드(mbnapi.h)

중요

Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.

디바이스에서 받은 신호 강도를 가져옵니다.

구문

HRESULT GetSignalStrength(
  [out, retval] ULONG *signalStrength
);

매개 변수

[out, retval] signalStrength

디바이스에서 수신한 신호 품질에 대한 포인터입니다. 신호 강도를 알 수 없거나 디바이스에서 감지할 수 없는 경우 이 값은 MBN_RSSI_UNKNOWN. 이 메서드가 S_OK 이외의 값을 반환하는 경우 이 매개 변수는 0입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 완료되었습니다.
E_PENDING	신호 품질을 사용할 수 없습니다. 모바일 광대역 서비스는 현재 이 정보를 검색하기 위해 디바이스를 검색하고 있습니다. 신호 품질을 사용할 수 있는 경우 모바일 광대역 서비스는 IMbnSignalEvents의 OnSignalStateChange 메서드를 호출합니다.

설명

GetSignalStrength 는 모바일 광대역 디바이스에서 받은 신호 강도를 보고합니다. GSM 기반 디바이스의 경우 신호 강도를 코딩된 값으로 받은 신호 강도로 보고합니다. CDMA 디바이스의 경우 원시 RSSI를 기반으로 하지 않고 보정된 RSSI(노이즈 계정)를 기반으로 보고합니다.

다음 표에는 반환될 수 있는 코딩된 값이 포함되어 있습니다.

신호 강도(dBm)	코딩된 값(최소: 0 최대: 31)
-113 이하	0
-111	1
-109	2
...	...
...	...
-51 이상	31
알 수 없거나 감지할 수 없음	MBN_RSSI_UNKNOWN

 

복구 가능한 오류 E_MBN_PIN_REQUIRED 및 E_MBN_RADIO_POWER_OFF 경우 모바일 광대역 서비스는 오류 조건이 끝나면 디바이스에 신호 상태를 다시 쿼리합니다. 이 메서드는 쿼리 작업이 완료될 때까지 E_PENDING 반환합니다. 새 쿼리가 완료되면 모바일 광대역 서비스는 IMbnSignalEvents의 OnSignalStateChange 메서드를 호출합니다.

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	mbnapi.h

참고 항목

IMbnSignal