lineSetCallParams 함수(tapi.h)

아티클
08/26/2023

lineSetCallParams 함수를 사용하면 애플리케이션이 전달자 모드 및/또는 기존 호출의 속도 매개 변수를 변경할 수 있습니다.

구문

LONG lineSetCallParams(
  HCALL                  hCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

매개 변수

hCall

매개 변수를 변경할 호출에 대한 핸들입니다. 애플리케이션은 호출의 소유자여야 합니다. hCall의 호출 상태는 유휴 상태 또는 연결 끊김을 제외한 모든 상태일 수 있습니다.

dwBearerMode

호출에 대한 새 전달자 모드입니다. 이 매개 변수는 LINEBEARERMODE_ 상수 중 하나만 사용합니다.

dwMinRate

호출의 새 데이터 속도에 대한 하한입니다. 애플리케이션은 이 속도만큼 낮은 새 속도를 허용할 수 있습니다.

dwMaxRate

호출의 새 데이터 속도에 대한 상한입니다. 이는 애플리케이션에서 허용할 수 있는 최대 데이터 속도입니다. 정확한 데이터 속도가 필요한 경우 dwMinRate 및 dwMaxRate 는 같아야 합니다.

lpDialParams

LINEDIALPARAMS 형식의 호출에 대한 새 다이얼 매개 변수에 대한 포인터입니다. 호출의 현재 전화 걸기 매개 변수를 사용하는 경우 이 매개 변수는 NULL 로 남을 수 있습니다.

반환 값

함수가 비동기적으로 완료된 경우 양수 요청 식별자를 반환하거나 오류가 발생할 경우 음수 오류 번호를 반환합니다. 함수가 성공하면 해당 LINE_REPLY 메시지의 dwParam2 매개 변수가 0이거나 오류가 발생하면 음수 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_BEARERMODEUNAVAIL, LINEERR_NOTOWNER, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RATEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALRATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM.