Share via


IRTCIntensityEvent

RTCE_INTENSITY events have an IRTCIntensityEvent interface. This type of event is fired when the intensity level changes on one of the audio devices.

When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_INTENSITY, the method's pEvent parameter is an IDispatch pointer for the IRTCIntensityEvent interface.

Note  You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCEF_INTENSITY event to enable reception of intensity events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.

Note  Audio intensity is the degree of loudness, or the range of soft and quiet sounds, within a given volume setting. The intensity is set with the IRTCClient::InvokeTuningWizard method.

Methods in Vtable Order

The IRTCIntensityEvent interface inherits the methods of the standard COM interface IUnknown.

In addition, IRTCIntensityEvent defines the following methods.

Method Description
get_Level Returns the level of intensity.
get_Min Returns the minimum level of intensity.
get_Max Returns the maximum level of intensity.
get_Direction Returns the audio device for which the intensity has changed.

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_IRTCIntensityEvent is defined as 4c23bf51-390c-4992-a41d-41eec05b2a4b.