Share via


IRTCClient::get_NetworkQuality

The get_NetworkQuality property returns a value that describes the quality of the network connection. The value ranges between 0 (worst quality) and 100 (best quality), and is computed based on packet loss, jitter, and round-trip time values reported by the streaming components. You should call the get_NetworkQuality method whenever an RTCE_CLIENT event of type RTCCET_NETWORK_QUALITY_CHANGE is fired.

HRESULT get_NetworkQuality(long*plNetworkQuality);

Parameters

  • plNetworkQuality
    [out] Pointer to a long containing the network quality.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
RTC_E_CLIENT_NOT_INITIALIZED The client has not been initialized.
S_FALSE The network quality is not available, or the remote party has been disconnected.

Requirements

Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCClient is defined as 07829e45-9a34-408e-a011-bddf13487cd1.

See Also

IRTCClient