ITLegacyCallMediaControl2::D etectTonesByCollection 메서드(tapi3if.h)

  • 아티클

DetectTonesByCollection 메서드는 호출 시 인밴드 톤 검색을 사용하도록 설정하고 사용하지 않도록 설정합니다. 지정된 톤이 검색될 때마다 메시지가 애플리케이션으로 전송됩니다.

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

구문

HRESULT DetectTonesByCollection(
  [in] ITCollection2 *pDetectToneCollection
);

매개 변수

[in] pDetectToneCollection

모니터링할 톤을 나타내는 ITDetectTone 인터페이스 포인터 컬렉션을 포함하는 ITCollection2 인터페이스에 대한 포인터입니다. 목록의 각 톤에는 TE_TONEEVENT 이벤트에서 톤 감지를 보고할 때 개별 톤을 식별하는 데 사용되는 애플리케이션 정의 태그 필드가 있습니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

반환 값

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

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

설명

이 메서드는 TAPI 2로 변환됩니다. xlineMonitorTones 호출.

진행 중인 톤 모니터링을 취소하려면 DetectTonesByCollection 메서드를 호출하고 빈 컬렉션을 지정합니다. 모니터링할 톤 목록을 변경하려면 이 메서드를 호출하고 새 톤 컬렉션을 지정합니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tapi3if.h
라이브러리 Uuid.lib
DLL Tapi3.dll

추가 정보

ITCollection2

ITDetectTone

ITLegacyCallMediaControl2