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

  • 아티클

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

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

구문

HRESULT DetectTones(
  [in] TAPI_DETECTTONE *pToneList,
  [in] long            lNumTones
);

매개 변수

[in] pToneList

검색할 톤을 지정하는 TAPI_DETECTTONE 배열에 대한 포인터입니다. 배열의 각 톤 에는 TE_TONEEVENT 형식 의 톤 검색 이벤트가 보고되는 경우 목록의 개별 톤을 식별하는 데 사용되는 애플리케이션 정의 태그 필드가 있습니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

[in] lNumTones

pToneList 매개 변수로 지정된 배열의 항목 수입니다. pToneList가 NULL인 경우 이 매개 변수는 무시됩니다.

반환 값

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

반환 코드 Description
S_OK
 메서드가 정상적으로 실행되었습니다.
E_POINTER
 pToneList 매개 변수가 유효한 포인터가 아닙니다.
TAPI_E_INVALCALLSTATE
 호출이 연결된 상태여야 합니다.

설명

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

진행 중인 톤 모니터링을 취소하려면 DetectTones 메서드를 호출하고 NULLpToneList 매개 변수를 지정합니다. 모니터링할 톤 목록을 변경하려면 이 메서드를 호출하고 새 톤 목록을 지정합니다.

요구 사항

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

추가 정보

ITLegacyCallMediaControl2

TAPI_DETECTTONE