LINECALLPARAMS 구조체(tapi.h)
LINECALLPARAMS 구조는 lineMakeCall 및 TSPI_lineMakeCall 함수를 사용하여 호출할 때 제공되는 매개 변수를 설명합니다. LINECALLPARAMS 구조체는 lineOpen 함수와 같은 다른 작업에서도 매개 변수로 사용됩니다.
구문 블록 오른쪽에 있는 주석은 이 구조체가 lineMakeCall에 제공되지 않을 때 사용되는 기본값을 나타냅니다.
구문
typedef struct linecallparams_tag {
DWORD dwTotalSize;
DWORD dwBearerMode;
DWORD dwMinRate;
DWORD dwMaxRate;
DWORD dwMediaMode;
DWORD dwCallParamFlags;
DWORD dwAddressMode;
DWORD dwAddressID;
LINEDIALPARAMS DialParams;
DWORD dwOrigAddressSize;
DWORD dwOrigAddressOffset;
DWORD dwDisplayableAddressSize;
DWORD dwDisplayableAddressOffset;
DWORD dwCalledPartySize;
DWORD dwCalledPartyOffset;
DWORD dwCommentSize;
DWORD dwCommentOffset;
DWORD dwUserUserInfoSize;
DWORD dwUserUserInfoOffset;
DWORD dwHighLevelCompSize;
DWORD dwHighLevelCompOffset;
DWORD dwLowLevelCompSize;
DWORD dwLowLevelCompOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwPredictiveAutoTransferStates;
DWORD dwTargetAddressSize;
DWORD dwTargetAddressOffset;
DWORD dwSendingFlowspecSize;
DWORD dwSendingFlowspecOffset;
DWORD dwReceivingFlowspecSize;
DWORD dwReceivingFlowspecOffset;
DWORD dwDeviceClassSize;
DWORD dwDeviceClassOffset;
DWORD dwDeviceConfigSize;
DWORD dwDeviceConfigOffset;
DWORD dwCallDataSize;
DWORD dwCallDataOffset;
DWORD dwNoAnswerTimeout;
DWORD dwCallingPartyIDSize;
DWORD dwCallingPartyIDOffset;
DWORD dwAddressType;
} LINECALLPARAMS, *LPLINECALLPARAMS;
멤버
dwTotalSize
이 데이터 구조에 할당된 총 크기(바이트)입니다. 이 크기는 이 데이터 구조의 고정 및 고정 크기 부분을 모두 보유할 수 있을 만큼 커야 합니다.
dwBearerMode
호출에 대한 전달자 모드입니다. 이 멤버는 LINEBEARERMODE_ 상수 중 하나를 사용합니다.
dwBearerMode가 0이면 기본값이 LINEBEARERMODE_VOICE.
dwMinRate
호출의 데이터 스트림에 대해 요청된 최소 데이터 속도(bps(초당 비트)입니다.
dwMaxRate
호출의 데이터 스트림에 대해 요청된 최대 데이터 속도(bps(초당 비트)입니다. 호출을 수행할 때 서비스 공급자는 요청된 범위에서 사용 가능한 가장 높은 속도(dwMinRate 에서 dwMaxRate로)를 제공하려고 시도합니다. 특정 데이터 속도가 필요한 경우 dwMinRate 와 dwMaxRate 를 모두 해당 값으로 설정해야 합니다. 애플리케이션이 하나의 속도에서 가장 잘 작동하지만 더 낮은 비율로 저하할 수 있는 경우 애플리케이션은 각각 이를 최대 및 최소 요금으로 지정해야 합니다. dwMaxRate가 0이면 기본값은 LINEDEVCAPS 구조체의 dwMaxRate 멤버에 의해 지정됩니다. 디바이스에서 지원하는 최대 속도입니다.
dwMediaMode
호출의 예상 미디어 유형입니다. 이 멤버는 LINEMEDIAMODE_ 상수 중 하나를 사용합니다.
dwMediaMode가 0이면 기본값은 LINEMEDIAMODE_INTERACTIVEVOICE.
dwCallParamFlags
부울 호출 설정 매개 변수의 컬렉션입니다. 이 멤버는 하나 이상의 LINECALLPARAMFLAGS_ 상수를 사용합니다.
dwAddressMode
원래 주소를 지정하는 모드입니다. 이 멤버는 LINEADDRESSMODE_ 상수 중 하나를 사용합니다.
dwAddressID
dwAddressMode가 LINEADDRESSMODE_ADDRESSID 설정된 경우 원래 주소의 주소 식별자입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.
DialParams
이 호출에 사용할 DIAL 매개 변수는 LINEDIALPARAMS 형식입니다. 이 필드에 값 0을 지정하면 LINEDEVCAPS 구조체의 DefaultDialParams 멤버에 표시된 대로 필드의 기본값이 사용됩니다. 0이 아닌 값이 LINEDEVCAPS 구조체의 MinDialParams 및 MaxDialParams에 있는 해당 필드에 지정된 범위를 벗어난 필드에 대해 지정된 경우 유효한 범위 내에서 가장 가까운 값이 대신 사용됩니다.
dwOrigAddressSize
원래 주소 필드의 크기(바이트)입니다.
dwOrigAddressOffset
구조체의 시작 부분에서 원래 주소를 포함하는 고정 크기 필드로 오프셋됩니다. 이 주소의 형식은 dwAddressMode 멤버에 따라 달라집니다. 필드의 크기는 dwOrigAddressSize로 지정됩니다.
dwDisplayableAddressSize
null 종결자를 포함하여 표시 가능한 문자열의 크기(바이트)입니다.
dwDisplayableAddressOffset
로깅 목적으로 사용되는 표시 가능한 문자열입니다. 이러한 멤버의 콘텐츠는 호출 LINECALLINFO 메시지의 dwDisplayableAddressOffset 및 dwDisplayableAddressSize 멤버에 기록됩니다. lineTranslateAddress 함수는 LINETRANSLATEOUTPUT 구조체의 dwDisplayableAddressSize 및 dwDisplayableAddressOffset 멤버에서 이 필드에 배치할 적절한 정보를 반환합니다. 필드의 크기는 dwDisplayableAddressSize로 지정됩니다.
dwCalledPartySize
호출된 파티 정보의 크기(바이트)입니다.
dwCalledPartyOffset
구조체의 시작 부분에서 호출된 파티 정보를 보유하는 고정 크기 필드로 오프셋됩니다. 이 정보는 호출을 수행하고 로깅을 위해 호출의 정보 구조에서 사용할 수 있는 애플리케이션에서 지정할 수 있습니다. 이 필드의 형식은 LINEDEVCAPS에 지정된 대로 dwStringFormat의 형식입니다. 필드의 크기는 dwCalledPartySize로 지정됩니다.
dwCommentSize
호출 주석 필드의 크기(바이트)입니다.
dwCommentOffset
구조체의 시작 부분에서 호출에 대한 주석이 있는 고정 크기 필드로 오프셋됩니다. 이 정보는 호출을 수행하고 로깅을 위해 호출의 정보 구조에서 사용할 수 있는 애플리케이션에서 지정할 수 있습니다. 이 필드의 형식은 LINEDEVCAPS에 지정된 대로 dwStringFormat의 형식입니다. 필드의 크기는 dwCommentSize로 지정됩니다.
dwUserUserInfoSize
null 종결자를 포함한 사용자-사용자 정보의 크기(바이트)입니다.
dwUserUserInfoOffset
구조체의 시작 부분에서 사용자-사용자 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필요한 경우 사용자-사용자 정보에 대한 프로토콜 판별자 필드는 dwUserUserInfoOffset이 가리키는 데이터의 첫 번째 바이트로 표시되어야 하며 dwUserUserInfoSize에서 를 고려해야 합니다.
dwHighLevelCompSize
상위 수준 호환성 정보의 크기(바이트)입니다.
dwHighLevelCompOffset
구조체의 시작 부분에서 높은 수준의 호환성 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwHighLevelCompSize로 지정됩니다.
dwLowLevelCompSize
하위 수준 호환성 정보의 크기(바이트)입니다.
dwLowLevelCompOffset
구조체의 시작 부분에서 낮은 수준의 호환성 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwLowLevelCompSize로 지정됩니다.
dwDevSpecificSize
디바이스별 정보의 크기(바이트)입니다.
dwDevSpecificOffset
구조체의 시작 부분에서 디바이스별 정보를 보유하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwDevSpecificSize로 지정됩니다.
dwPredictiveAutoTransferStates
LINECALLSTATE_ 상수를 입력하면 호출이 지정된 대상 주소로 블라인드 전송됩니다. 자동 전송을 원하지 않는 경우 0으로 설정합니다.
dwTargetAddressSize
null 종결자를 포함한 대상 전화 걸기 가능 주소 문자열의 크기(바이트)입니다.
dwTargetAddressOffset
구조체의 시작 부분에서 대상 전화 걸기 가능 주소를 지정하는 문자열로 오프셋( dwAddressID 아님) 특정 자동 작업의 경우 사용됩니다. 예측 전화 걸기의 경우 호출을 자동으로 전송할 주소를 지정합니다. 문자열의 크기는 dwTargetAddressSize로 지정됩니다.
이는 기본적으로 자동 전송이 사용되지 않는 경우 lineBlindTransfer 에 전달되는 것과 동일한 문자열입니다. 자동 전송을 원하지 않는 경우 0으로 설정합니다. 보류 안 됨 회의의 경우 는 통화에 전화 회의해야 하는 주소를 지정합니다. 원스텝 전송의 경우 상담 전화를 걸 주소를 지정합니다.
dwSendingFlowspecSize
서비스 정보의 품질 크기(바이트)입니다.
dwSendingFlowspecOffset
구조체의 시작 부분에서 FLOWSPEC 구조로 오프셋한 다음 WinSock 공급자별 데이터(QOS 구조의 SendFlowspec에 저장된 데이터와 동일). 통화의 송신 방향에서 원하는 서비스 품질을 지정합니다. TAPI는 프라이빗 포인터가 가리키는 데이터를 마샬링하고 프로세스 간 통신을 통해 애플리케이션에 전달하는 방법을 모르기 때문에 FLOWSPEC 구조 다음에 있는 공급자 관련 부분에는 다른 메모리 블록에 대한 포인터가 포함되어서는 안 됩니다. 필드의 크기는 dwSendingFlowspecSize로 지정됩니다.
dwReceivingFlowspecSize
서비스 정보의 품질 크기(바이트)입니다.
dwReceivingFlowspecOffset
구조체의 시작 부분에서 FLOWSPEC 구조로 오프셋한 다음 WinSock 공급자별 데이터(QOS 구조의 ReceivingFlowspec에 저장된 데이터와 동일). 통화의 수신 방향에서 원하는 서비스 품질을 지정합니다. TAPI는 프라이빗 포인터가 가리키는 데이터를 마샬링하고 프로세스 간 통신을 통해 애플리케이션에 전달하는 방법을 모르기 때문에 FLOWSPEC 구조 다음에 있는 공급자 관련 부분에는 다른 메모리 블록에 대한 포인터가 포함되어서는 안 됩니다. 필드의 크기는 dwReceivingFlowspecSize로 지정됩니다.
dwDeviceClassSize
null 종결자를 포함한 디바이스 클래스 문자열의 크기(바이트)입니다.
dwDeviceClassOffset
구조체의 시작 부분에서 DeviceConfig에 구성이 지정된 디바이스의 디바이스 클래스를 나타내는 null로 끝나는 문자열로 오프셋됩니다. 유효한 디바이스 클래스 문자열은 lineGetID 함수에 지정된 문자열과 동일합니다. 문자열의 크기는 dwDeviceClassSize로 지정됩니다.
dwDeviceConfigSize
디바이스 구성 데이터의 크기(바이트)입니다.
dwDeviceConfigOffset
구조체의 시작 부분에서 불투명 구성 데이터 구조로 오프셋합니다. 이 값은 lineGetDevConfig에서 반환된 VARSTRING 구조체의 dwStringSize 멤버에 반환됩니다. 크기가 0이면 기본 디바이스 구성이 사용됩니다. 이렇게 하면 호출이 시작되기 전에 애플리케이션에서 디바이스 구성을 설정할 수 있습니다. 필드의 크기는 dwDeviceConfigSize로 지정됩니다.
dwCallDataSize
애플리케이션 설정 가능 호출 데이터의 크기(바이트)입니다.
dwCallDataOffset
구조체의 시작 부분에서 호출에 처음 연결할 애플리케이션 설정 가능 호출 데이터로 오프셋됩니다. 필드의 크기는 dwCallDataSize로 지정됩니다.
dwNoAnswerTimeout
전화 걸기 완료 후 서비스 공급자가 LINECALLSTATE_DISCONNECTED 및 LINEDISCONNECTMODE_NOANSWER 사용하여 자동으로 중단되기 전에 통화가 PROCEEDING 또는 RINGBACK 상태에서 대기하도록 허용되어야 하는 시간(초)입니다. 값 0은 애플리케이션이 자동 호출 중단을 원하지 않음을 나타냅니다.
dwCallingPartyIDSize
null 종결자를 포함한 호출 당사자 ID 문자열의 크기(null 종료 문자를 포함하여 바이트)입니다.
dwCallingPartyIDOffset
구조체의 시작 부분에서 호출을 배치하는 파티의 ID를 지정하는 null로 끝나는 문자열로 오프셋됩니다. 식별자의 콘텐츠가 허용되고 경로를 사용할 수 있는 경우 서비스 공급자는 호출된 파티에 식별자를 전달하여 호출 당사자의 ID를 나타냅니다. 필드의 크기는 dwCallingPartyIDSize로 지정됩니다.
dwAddressType
호출에 사용되는 주소 유형입니다. 구조체의 이 멤버는 협상된 TAPI 버전이 3.0 이상인 경우에만 사용할 수 있습니다.
설명
디바이스별 확장은 이 데이터 구조의 DevSpecific(dwDevSpecificSize 및 dwDevSpecificOffset) 크기의 영역을 사용해야 합니다.
이 구조체는 호출을 설정할 때 lineMakeCall 에 대한 매개 변수로 사용됩니다. 해당 필드를 사용하면 애플리케이션이 네트워크에서 요청된 서비스 품질과 다양한 ISDN 호출 설정 매개 변수를 지정할 수 있습니다. lineMakeCall에 LINECALLPARAMS 구조가 제공되지 않으면 위에 나열된 기본값으로 기본 POTS 음성 등급 호출이 요청됩니다.
요구 사항
| 머리글 | tapi.h |