ITLegacyCallMediaControl2::GenerateCustomTonesByCollection 메서드(tapi3if.h)

GenerateCustomTonesByCollection 메서드는 지정된 사용자 지정 톤을 생성합니다.

이 메서드는 Visual Basic 및 스크립팅 애플리케이션을 위한 것입니다. C/C++ 애플리케이션은 대신 GenerateCustomTones 메서드를 사용해야 합니다.

구문

HRESULT GenerateCustomTonesByCollection(
  [in] ITCollection2 *pCustomToneCollection,
  [in] long          lDuration
);

[in] pCustomToneCollection

톤 구성 요소를 나타내는 ITCustomTone 인터페이스 포인터의 컬렉션을 포함하는 ITCollection2 인터페이스에 대한 포인터입니다. 컬렉션이 다중 주파수 톤인 경우 다양한 톤이 동시에 재생됩니다.

[in] lDuration

톤을 유지해야 하는 기간(밀리초)입니다. 값이 0이면 기본 기간이 사용됩니다.

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

반환 코드	Description
S_OK	메서드가 정상적으로 실행되었습니다.
E_POINTER	pCustomToneCollection 매개 변수가 유효한 포인터가 아닙니다.
E_OUTOFMEMORY	톤 버퍼를 할당할 메모리가 부족합니다.
TAPI_E_INVALCALLSTATE	호출은 연결된 상태여야 합니다.

이 메서드는 TAPI 2에 대한 호출로 변환됩니다. xlineGenerateTone 함수입니다.

톤 생성이 완료되면 TE_GENERATEEVENT 형식의 이벤트가 생성됩니다.