TSPI_lineGenerateDigits 함수(tspi.h)

아티클
08/26/2023

TSPI_lineGenerateDigits 함수는 지정된 신호 모드를 사용하여 지정된 호출에서 지정된 숫자를 대역 내 톤으로 생성하기 시작합니다. 숫자 또는 톤 생성이 진행되는 동안 이 함수를 호출하면 현재 숫자 또는 톤 생성이 중단됩니다. lpsDigits에 NULL 값을 전달하면 새 숫자가 생성되지 않습니다.

참고 한 번에 하나의 대역 내 생성 요청(톤 생성 또는 숫자 생성)만 호출당 진행될 수 있습니다.

구문

LONG TSPIAPI TSPI_lineGenerateDigits(
  HDRVCALL hdCall,
  DWORD    dwEndToEndID,
  DWORD    dwDigitMode,
  LPCWSTR  lpszDigits,
  DWORD    dwDuration
);

매개 변수

hdCall

숫자 생성을 수행할 호출에 대한 핸들입니다.

dwEndToEndID

이 고유한 요청 식별자는 서비스 공급자에 의해 저장되고 숫자 생성이 완료되면 LINEEVENT 프로시저에 dwParam2로 다시 전달되어야 합니다.

dwDigitMode

이러한 숫자를 신호하는 데 사용할 형식입니다. 이 매개 변수는 LINEDIGITMODE_ 상수 중 하나만 사용합니다.

lpszDigits

생성할 숫자를 포함하는 null로 끝나는 유니코드 문자 버퍼에 대한 포인터입니다. 쉼표는 이전의 신호와 구분된 다음 숫자 사이에 추가 지연을 삽입합니다. 이 일시 중지 기간은 구성이 정의됩니다. 줄의 디바이스 기능은 이 기간이 무엇인지 나타냅니다. 여러 쉼표는 더 긴 일시 중지를 삽입하는 데 사용할 수 있습니다. 잘못된 숫자는 오류로 보고되지 않고 생성 중에 무시됩니다.

dwDuration

DTMF 숫자와 펄스 및 DTMF 숫자 간 간격의 지속 시간(밀리초)을 모두 지정합니다. 값 0은 기본값을 사용합니다. dwDuration 매개 변수는 MINDialParams에서 LINEDEVCAPS의 MaxDialParams로 지정된 범위 내에 있어야 합니다. 범위를 벗어나면 서비스 공급자가 실제 값을 범위에서 가장 가까운 값으로 설정합니다. 이 함수가 호출될 때 TAPI에서 이 매개 변수의 유효성을 검사하지 않습니다.

반환 값

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

LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDIGITMODE, LINEERR_OPERATIONFAILED, LINEERR_RESOURCEUNAVAIL, LINEERR_RESOURCEUNAVAIL.

설명

hdCall의 호출 상태는 모든 상태일 수 있습니다.

TSPI_lineGenerateDigits 함수는 숫자 생성이 성공적으로 시작될 때 성공적으로 완료된 것으로 간주됩니다. 모든 숫자가 생성되는 경우는 아닙니다.

lpsDigits의 모든 숫자가 생성되거나 숫자 생성이 중단되거나 취소된 후 LINE_GENERATE 메시지가 TAPI로 전송됩니다.

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

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