lineGenerateDigits 함수(tapi.h)

아티클
03/08/2023

lineGenerateDigits 함수는 지정된 신호 모드를 사용하여 지정된 호출에서 지정된 숫자를 인밴드 톤으로 생성합니다. lpszDigits에 대해 NULL 값으로 이 함수를 호출하면 현재 진행 중인 모든 숫자 생성이 중단됩니다. 숫자 생성이 진행 중인 동안 lineGenerateDigits 또는 lineGenerateTone 을 호출하면 현재 숫자 생성 또는 톤 생성이 중단되고 가장 최근에 지정된 숫자 또는 톤 생성이 시작됩니다.

구문

LONG lineGenerateDigits(
  HCALL  hCall,
  DWORD  dwDigitMode,
  LPCSTR lpszDigits,
  DWORD  dwDuration
);

매개 변수

hCall

호출에 대한 핸들입니다. 애플리케이션은 호출의 소유자여야 합니다. hCall의 호출 상태는 모든 상태일 수 있습니다. TAPI는 호출 상태 요구 사항을 적용하지 않지만 일부 Tapi 서비스 공급자는 hCall이 LINECALLSTATE_CONNECTED 상태여야 할 수 있습니다.

dwDigitMode

이러한 숫자를 신호하는 데 사용할 형식입니다. dwDigitMode에는 단일 플래그 집합만 있을 수 있습니다. 이 매개 변수는 LINEDIGITMODE_ 상수 중 하나를 사용합니다.

lpszDigits

생성할 숫자를 포함하는 null로 끝나는 문자 버퍼에 대한 포인터입니다. 유효한 문자는 dwDigitModes에 제공된 LINEDIGITMODE_ 상수에 대해 지정된 문자입니다.

또한 쉼표(,)도 유효한 문자입니다. 쉼표는 이전의 신호와 구분된 다음 숫자 사이에 추가 지연을 삽입합니다. 이 일시 중지 기간은 구성이 정의되며, 라인 디바이스 기능은 이 기간을 나타냅니다. 여러 쉼표는 더 긴 일시 중지를 삽입하는 데 사용할 수 있습니다. 잘못된 숫자는 오류로 보고되지 않고 생성 중에 무시됩니다.

느낌표(!)는 유효한 문자입니다. 이 문자는 전화 걸기 가능 주소에 대해 설명된 대로 "hookflash" 작업을 수행합니다.

dwDuration

DTMF 숫자와 펄스 및 DTMF 숫자 간 간격의 기간(밀리초)입니다. 값 0은 기본값을 사용합니다. dwDuration 매개 변수는 LINEDEVCAPS의 MinDialParams 및 MaxDialParams에 지정된 범위 내에 있어야 합니다. 범위를 벗어나면 실제 값이 범위에서 가장 가까운 값으로 설정됩니다.

반환 값

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

LINEERR_INVALCALLHANDLE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDIGITMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

설명

lineGenerateDigits 함수는 모든 숫자가 생성된 시점이 아니라 숫자 생성이 성공적으로 시작되었을 때 성공적으로 완료된 것으로 간주됩니다. lineGenerateDigits는 네트워크 종속 방식으로 숫자를 다이얼하는 lineDial과 달리 펄스를 사용할 때 DTMF 또는 후크스위치 다이얼 펄스를 사용하여 음성 채널을 통해 숫자를 인밴드 톤으로 생성하도록 보장합니다. lineGenerateDigits 함수는 일반적으로 전화를 걸거나 전화를 걸 때 적합하지 않습니다. 설정된 호출을 통해 엔드 투 엔드 신호를 위한 것입니다.

lpszDigits의 모든 숫자가 생성되거나 숫자 생성이 중단되거나 취소된 후 LINE_GENERATE 메시지가 애플리케이션에 전송됩니다.

호출 소유자인 모든 애플리케이션에서 호출당 하나의 인밴드 생성 요청(톤 생성 또는 숫자 생성)만 진행되도록 허용됩니다. 호출의 숫자 생성은 다른 숫자 생성 요청 또는 톤 생성 요청을 시작하여 취소됩니다. 현재 숫자 생성을 취소하기 위해 애플리케이션은 lineGenerateDigits를 호출하고 lpszDigits 매개 변수에 대해 NULL을 지정할 수 있습니다.

서비스 공급자 및 하드웨어에 따라 애플리케이션은 자체 생성 숫자를 모니터링할 수 있습니다. 원하는 것이 아닌 경우 애플리케이션은 숫자를 생성하는 동안 숫자 모니터링을 사용하지 않도록 설정할 수 있습니다.