TSPI_lineGenerateTone 함수(tspi.h)

아티클
08/26/2023

TSPI_lineGenerateTone 함수는 지정된 호출을 통해 지정된 톤 인밴드를 생성합니다. dwToneMode에 대해 0으로 이 함수를 호출하면 지정된 호출에서 현재 진행 중인 톤 생성이 중단됩니다. 톤 생성이 진행되는 동안 TSPI_lineGenerateTone 또는 TSPI_lineGenerateDigits 호출하면 현재 톤 생성 또는 숫자 생성이 중단되고 새로 지정된 톤 또는 숫자의 생성이 시작됩니다.

구문

LONG TSPIAPI TSPI_lineGenerateTone(
  HDRVCALL                 hdCall,
  DWORD                    dwEndToEndID,
  DWORD                    dwToneMode,
  DWORD                    dwDuration,
  DWORD                    dwNumTones,
  LPLINEGENERATETONE const lpTones
);

매개 변수

hdCall

톤 생성을 수행할 호출에 대한 서비스 공급자의 핸들입니다. hdCall의 호출 상태는 유휴 상태를 제외한 모든 상태일 수 있습니다.

dwEndToEndID

전체 수명, 즉 일치하는 LINE_GENERATE 메시지가 전송될 때까지 요청의 고유하고 해석되지 않은 식별자입니다. 서비스 공급자는 메시지의 매개 변수 중 하나로 이 식별자를 포함합니다.

dwToneMode

생성할 톤을 정의합니다. 톤은 표준 또는 사용자 정의일 수 있습니다. 사용자 지정 톤은 임의의 빈도 집합으로 구성됩니다. 소수의 표준 톤이 미리 정의되어 있습니다. 톤 지속 시간은 표준 및 사용자 지정 톤 모두에 대해 dwDuration 으로 지정됩니다. dwToneMode를 0으로 설정하면 진행 중인 모든 숫자 또는 톤 생성이 취소됩니다. 이 매개 변수는 LINETONEMODE_ 상수 중 하나만 사용합니다.

dwDuration

톤이 지속되는 기간(밀리초)입니다. dwDuration의 경우 값 0은 지정된 톤에 대한 기본 기간을 사용합니다. 기본값은 다음과 같습니다.

사용자 지정: 무한

링백: 무한

사용 중: 무한

BEEP: 무한

청구: 고정(단일 주기)

이 함수가 호출될 때 TAPI에서 이 매개 변수의 유효성을 검사하지 않습니다.

dwNumTones

lpTones 배열의 항목 수입니다. dwToneMode가 LINETONEMODE_CUSTOM 같지 않으면 이 매개 변수는 무시됩니다.

lpTones

톤 구성 요소를 지정하는 LINEGENERATETONE 배열에 대한 포인터입니다. 이 매개 변수는 비사용자 톤에 대해 무시됩니다. lpTones가 다중 주파수 톤인 경우 다양한 톤이 동시에 재생됩니다.

반환 값

함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALTONEMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALTONE, LINEERR_RESOURCEUNAVAIL, LINEERR_RESOURCEUNAVAIL.

설명

TSPI_lineGenerateTone 톤 생성이 성공적으로 시작되면 0(성공)을 반환합니다. 음색의 생성이 완료된 경우는 아닙니다. 이 함수를 사용하면 링백, 사용 중인 톤 및 비프음과 같은 미리 정의된 여러 톤의 인밴드 생성을 허용합니다. 또한 서비스 공급자가 지원하는 경우 구성 요소 빈도, 주기 및 볼륨을 지정하여 사용자 지정 톤을 제작할 수 있습니다. 이러한 톤은 인밴드 톤으로 생성되기 때문에 톤 생성이 효과적이려면 일반적으로 호출이 연결된 상태여야 합니다. 톤 생성이 완료되거나 톤 생성이 취소되면 LINE_GENERATE 메시지가 TAPI로 전송됩니다.

참고 호출당 하나의 인밴드 생성 요청(톤 생성 또는 숫자 생성)만 진행되도록 허용됩니다. 즉, 현재 통화에서 톤 생성이 진행 중인 경우 TSPI_lineGenerateDigits 또는 TSPI_lineGenerateTone 호출하면 톤 생성이 취소됩니다. 서비스 공급자는 후속 TSPI_lineGenerateDigits 또는 TSPI_lineGenerateTone 함수가 호출될 때 진행 중인 톤 생성을 종료해야 합니다.

TAPI 수준의 해당 함수에는 공식 매개 변수 dwEndToEndID가 포함되지 않습니다. 이 수준에서는 엔드 투 엔드 표시가 없습니다. TAPI는 TSPI 수준에서 엔드 투 엔드 표시를 사용하여 한 TSPI_lineGenerateTone 요청을 다른 요청과 구분합니다.