SomeAudioLevelInterface::AdviseNotify

From AVObjects Knowledge Base
Jump to: navigation, search


Syntax

HRESULT AdviseNotify(
  [in] AUDIO_LEVEL_FRONT eFront,
  [in] DWORD nChannel,
  [in] MEASURING_SYSTEM eSystem,
  [in] double dThreshold,
  [in] DWORD nDuration,
  [in] IAudioLevelNotify* pNotify,
  [out] DWORD* pdwAdviseCookie
);

Parameters

AUDIO_LEVEL_FRONT eFront

[in] Up or down front. For silence detection this parameter should be set to ALF_DOWN.

DWORD nChannel

[in] Number of channel.

MEASURING_SYSTEM eSystem

[in] The operation treshold can be set in decibels or percent. For percent use MSYSTEM_LEVEL_FACTOR.

double dThreshold

[in] If percentages are used, the treshold is set in values from 0 to 1 (i.e. 0.017, 0.5, etc.).

DWORD nDuration

[in] The duration of the operation treshold in milliseconds. For example, if the duration is set to 500 ms, the volume level should be below operation treshold (set in dThreshold) for a duration of at least 500 ms in order for the Begin event to be sent. As soon as volume level is back to above the treshold, the End event is sent.

IAudioLevelNotify* pNotify

[in] Callback pointer.

DWORD* pdwAdviseCookie)

[out] Unadvise cookie, etc.

Personal tools