다음을 통해 공유


LINECALLINFO 구조체(tapi.h)

LINECALLINFO 구조체에는 호출에 대한 정보가 포함됩니다. 이 정보는 호출 기간 동안 상대적으로 고정된 상태로 유지됩니다. 여러 함수는 LINECALLINFO를 사용합니다. 구조체는 lineGetCallInfo 함수 및 TSPI_lineGetCallInfo 함수에 의해 반환됩니다. 구조체의 일부가 변경되면 변경된 정보 항목을 나타내는 LINE_CALLINFO 메시지가 애플리케이션에 전송됩니다.

호출 진행률 상태 같은 호출에 대한 동적 변경 정보는 lineGetCallStatus 함수에 대한 호출로 반환되는 LINECALLSTATUS 구조에서 사용할 수 있습니다.

구문

typedef struct linecallinfo_tag {
  DWORD          dwTotalSize;
  DWORD          dwNeededSize;
  DWORD          dwUsedSize;
  HLINE          hLine;
  DWORD          dwLineDeviceID;
  DWORD          dwAddressID;
  DWORD          dwBearerMode;
  DWORD          dwRate;
  DWORD          dwMediaMode;
  DWORD          dwAppSpecific;
  DWORD          dwCallID;
  DWORD          dwRelatedCallID;
  DWORD          dwCallParamFlags;
  DWORD          dwCallStates;
  DWORD          dwMonitorDigitModes;
  DWORD          dwMonitorMediaModes;
  LINEDIALPARAMS DialParams;
  DWORD          dwOrigin;
  DWORD          dwReason;
  DWORD          dwCompletionID;
  DWORD          dwNumOwners;
  DWORD          dwNumMonitors;
  DWORD          dwCountryCode;
  DWORD          dwTrunk;
  DWORD          dwCallerIDFlags;
  DWORD          dwCallerIDSize;
  DWORD          dwCallerIDOffset;
  DWORD          dwCallerIDNameSize;
  DWORD          dwCallerIDNameOffset;
  DWORD          dwCalledIDFlags;
  DWORD          dwCalledIDSize;
  DWORD          dwCalledIDOffset;
  DWORD          dwCalledIDNameSize;
  DWORD          dwCalledIDNameOffset;
  DWORD          dwConnectedIDFlags;
  DWORD          dwConnectedIDSize;
  DWORD          dwConnectedIDOffset;
  DWORD          dwConnectedIDNameSize;
  DWORD          dwConnectedIDNameOffset;
  DWORD          dwRedirectionIDFlags;
  DWORD          dwRedirectionIDSize;
  DWORD          dwRedirectionIDOffset;
  DWORD          dwRedirectionIDNameSize;
  DWORD          dwRedirectionIDNameOffset;
  DWORD          dwRedirectingIDFlags;
  DWORD          dwRedirectingIDSize;
  DWORD          dwRedirectingIDOffset;
  DWORD          dwRedirectingIDNameSize;
  DWORD          dwRedirectingIDNameOffset;
  DWORD          dwAppNameSize;
  DWORD          dwAppNameOffset;
  DWORD          dwDisplayableAddressSize;
  DWORD          dwDisplayableAddressOffset;
  DWORD          dwCalledPartySize;
  DWORD          dwCalledPartyOffset;
  DWORD          dwCommentSize;
  DWORD          dwCommentOffset;
  DWORD          dwDisplaySize;
  DWORD          dwDisplayOffset;
  DWORD          dwUserUserInfoSize;
  DWORD          dwUserUserInfoOffset;
  DWORD          dwHighLevelCompSize;
  DWORD          dwHighLevelCompOffset;
  DWORD          dwLowLevelCompSize;
  DWORD          dwLowLevelCompOffset;
  DWORD          dwChargingInfoSize;
  DWORD          dwChargingInfoOffset;
  DWORD          dwTerminalModesSize;
  DWORD          dwTerminalModesOffset;
  DWORD          dwDevSpecificSize;
  DWORD          dwDevSpecificOffset;
  DWORD          dwCallTreatment;
  DWORD          dwCallDataSize;
  DWORD          dwCallDataOffset;
  DWORD          dwSendingFlowspecSize;
  DWORD          dwSendingFlowspecOffset;
  DWORD          dwReceivingFlowspecSize;
  DWORD          dwReceivingFlowspecOffset;
  DWORD          dwCallerIDAddressType;
  DWORD          dwCalledIDAddressType;
  DWORD          dwConnectedIDAddressType;
  DWORD          dwRedirectionIDAddressType;
  DWORD          dwRedirectingIDAddressType;
} LINECALLINFO, *LPLINECALLINFO;

멤버

dwTotalSize

이 데이터 구조에 할당된 총 크기(바이트)입니다.

dwNeededSize

반환된 모든 정보를 바이트 단위로 유지하는 데 필요한 이 데이터 구조의 크기입니다.

dwUsedSize

유용한 정보를 포함하는 이 데이터 구조의 부분 크기(바이트)입니다.

hLine

이 호출이 연결된 라인 디바이스에 대한 핸들입니다.

dwLineDeviceID

이 호출이 연결된 라인 디바이스의 디바이스 식별자입니다.

dwAddressID

이 호출이 있는 줄에 있는 주소의 주소 식별자입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.

dwBearerMode

호출의 현재 전달자 모드입니다. 이 멤버는 LINEBEARERMODE_ 상수 중 하나를 사용합니다.

dwRate

호출 데이터 스트림의 속도(bps(초당 비트)입니다.

dwMediaMode

현재 통화 중인 정보 스트림의 미디어 유형입니다. 이는 호출 소유자가 결정한 미디어 형식으로, 마지막 LINE_MONITORMEDIA 메시지와 반드시 동일하지는 않습니다. 이 멤버는 LINE_MONITORMEDIA 메시지의 직접적인 영향을 받지 않습니다. 이 멤버는 LINEMEDIAMODE_ 상수를 사용합니다.

dwAppSpecific

API 구현 및 서비스 공급자가 해석하지 않습니다. 이 호출의 소유자 애플리케이션은 lineSetAppSpecific 함수를 사용하여 설정할 수 있습니다.

dwCallID

일부 전화 통신 환경에서 스위치 또는 서비스 공급자는 각 호출에 고유 식별자를 할당할 수 있습니다. 이렇게 하면 전송, 전달 또는 기타 이벤트에서 호출을 추적할 수 있습니다. 이러한 호출 ID 및 해당 scope 도메인은 서비스 공급자 정의입니다. dwCallID 멤버를 사용하면 애플리케이션에서 이 고유 식별자를 사용할 수 있습니다.

dwRelatedCallID

호출 ID를 사용하는 전화 통신 환경에서는 한 호출을 다른 호출과 연결해야 하는 경우가 많습니다. 이 목적을 위해 서비스 공급자가 dwRelatedCallID 멤버를 사용할 수 있습니다.

dwCallParamFlags

호출이 나가는 경우 호출 관련 매개 변수의 컬렉션입니다. 이러한 매개 변수는 lineMakeCall에 지정된 것과 동일한 호출 매개 변수로, 하나 이상의 LINECALLPARAMFLAGS_ 상수입니다.

dwCallStates

이 호출에서 애플리케이션에 알림을 받을 수 있는 상태를 나타내는 하나 이상의 LINECALLSTATE_ 상수입니다. dwCallStates 멤버는 LINECALLINFO에서 상수이며 호출 상태에 따라 변경되지 않습니다.

dwMonitorDigitModes

다양한 숫자 모드. 이 멤버는 모니터링이 현재 활성화된 LINEDIGITMODE_ 상수 중 하나 이상입니다.

dwMonitorMediaModes

모니터링이 현재 사용하도록 설정된 다양한 미디어 유형입니다. 이 멤버는 LINEMEDIAMODE_ 상수 중 하나 이상입니다.

DialParams

현재 LINEDIALPARAMS 형식의 호출에 적용되는 전화 걸기 매개 변수입니다. 이러한 매개 변수가 lineMakeCall 또는 lineSetCallParams로 설정되지 않는 한 해당 값은 LINEDEVCAPS 구조에 사용되는 기본값과 동일합니다.

dwOrigin

호출이 시작된 위치를 식별합니다. 이 멤버는 LINECALLORIGIN_ 상수 중 하나일 수 있습니다.

dwReason

호출이 발생한 이유입니다. 이 멤버는 LINECALLREASON_ 상수 중 하나일 수 있습니다.

dwCompletionID

종료되는 완료 요청의 결과인 경우 들어오는 호출에 대한 완료 식별자입니다. 이 식별자는 dwReason 이 LINECALLREASON_CALLCOMPLETION 경우에만 의미가 있습니다.

dwNumOwners

호출에 대한 소유자 권한이 있는 다른 호출 핸들이 있는 애플리케이션 모듈의 수입니다.

dwNumMonitors

호출에 대한 모니터 권한이 있는 다른 호출 핸들이 있는 애플리케이션 모듈의 수입니다.

dwCountryCode

대상 파티의 국가 또는 지역 코드입니다. 알 수 없는 경우 0입니다.

dwTrunk

호출이 라우팅되는 트렁크의 수입니다. 이 멤버는 수신 및 발신 호출 모두에 사용됩니다. dwTrunk 멤버를 알 수 없는 경우 0xFFFFFFFF 설정해야 합니다.

dwCallerIDFlags

호출자 또는 발신자 파티 식별자 정보의 유효성 및 콘텐츠를 결정합니다. 이 멤버는 LINECALLPARTYID_ 상수 중 하나를 사용합니다.

dwCallerIDSize

호출자 ID 번호의 크기(바이트)입니다.

dwCallerIDOffset

이 구조체의 시작 부분에서 호출자 파티 ID 번호 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwCallerIDSize로 지정됩니다.

dwCallerIDNameSize

null 종결자를 포함한 호출자 ID 이름의 크기(바이트)입니다.

dwCallerIDNameOffset

이 구조체의 시작 부분에서 호출자 파티 ID 이름 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwCallerIDNameSize로 지정됩니다.

dwCalledIDFlags

호출된 파티 ID 정보의 유효성 및 콘텐츠를 결정합니다. 호출된 파티는 원래 주소가 지정된 파티에 해당합니다. 이 멤버는 LINECALLPARTYID_ 상수 중 하나를 사용합니다.

dwCalledIDSize

호출된 파티 ID 번호의 크기(바이트)입니다.

dwCalledIDOffset

구조체의 시작 부분에서 호출된 파티 ID 번호 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwCalledIDSize로 지정됩니다.

dwCalledIDNameSize

null 종결자를 포함한 호출된 파티 ID 이름의 크기(바이트)입니다.

dwCalledIDNameOffset

구조체의 시작 부분에서 호출된 파티 ID 이름 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwCalledIDNameSize로 지정됩니다.

dwConnectedIDFlags

연결된 파티 ID 정보의 유효성 및 콘텐츠를 결정합니다. 연결된 당사자는 실제로 연결된 파티입니다. 호출이 전환된 경우 호출된 당사자 ID와 다를 수 있습니다. 이 멤버는 LINECALLPARTYID_ 상수 중 하나를 사용합니다.

dwConnectedIDSize

연결된 파티 ID 번호의 크기(바이트)입니다.

dwConnectedIDOffset

이 구조체의 시작 부분에서 연결된 파티 ID 번호 정보가 포함된 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwConnectedIDSize로 지정됩니다.

dwConnectedIDNameSize

null 종결자를 포함한 연결된 당사자 ID 이름의 크기(바이트)입니다.

dwConnectedIDNameOffset

이 구조체의 시작 부분에서 연결된 파티 ID 이름 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwConnectedIDNameSize로 지정됩니다.

dwRedirectionIDFlags

리디렉션 파티 식별자 정보의 유효성 및 콘텐츠를 결정합니다. 리디렉션 당사자는 세션이 리디렉션된 주소를 식별합니다. 이 멤버는 LINECALLPARTYID_ 상수 중 하나를 사용합니다.

dwRedirectionIDSize

redirection-party ID 번호의 크기(바이트)입니다.

dwRedirectionIDOffset

구조체의 시작 부분에서 리디렉션 파티 ID 번호 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwRedirectionIDSize로 지정됩니다.

dwRedirectionIDNameSize

redirection-party ID 이름의 크기(바이트)입니다.

dwRedirectionIDNameOffset

구조체의 시작 부분에서 리디렉션 파티 ID 이름 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwRedirectionIDNameSize로 지정됩니다.

dwRedirectingIDFlags

리디렉션 파티 식별자 정보의 유효성 및 콘텐츠를 결정합니다. 리디렉션 당사자는 세션을 리디렉션하는 주소를 식별합니다. 이 멤버는 LINECALLPARTYID_ 상수 중 하나를 사용합니다.

dwRedirectingIDSize

redirecting-party ID 번호의 크기(바이트)입니다.

dwRedirectingIDOffset

구조체의 시작 부분에서 리디렉션 당사자 ID 번호 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwRedirectingIDSize로 지정됩니다.

dwRedirectingIDNameSize

null 종결자를 포함한 리디렉션 당사자 ID 이름의 크기(바이트)입니다.

dwRedirectingIDNameOffset

구조체의 시작 부분에서 리디렉션 파티 ID 이름 정보를 포함하는 고정 크기 필드로 오프셋합니다. 필드의 크기는 dwRedirectingIDNameSize로 지정됩니다.

dwAppNameSize

null 종결자를 포함한 애플리케이션 이름 필드의 크기(바이트)입니다.

dwAppNameOffset

구조체의 시작부터 호출을 처음 시작, 수락 또는 응답한 애플리케이션의 사용자 친화적인 이름을 포함하는 고정 크기 필드로 오프셋됩니다. 애플리케이션이 lineInitializeEx에서 지정할 수 있는 이름입니다. 애플리케이션에서 이러한 이름을 지정하지 않으면 애플리케이션의 모듈 파일 이름이 대신 사용됩니다. 필드의 크기는 dwAppNameSize로 지정됩니다.

dwDisplayableAddressSize

null 종결자를 포함한 표시 가능한 주소 문자열의 크기(바이트)입니다.

dwDisplayableAddressOffset

표시 가능한 문자열은 로깅 목적으로 사용됩니다. 이 정보는 호출을 시작하는 함수에 대한 LINECALLPARAMS 에서 가져옵니다. lineTranslateAddress 함수는 LINETRANSLATEOUTPUT 구조체의 dwDisplayableAddressSizedwDisplayableAddressOffset 멤버에서 이 필드에 배치할 적절한 정보를 반환합니다.

dwCalledPartySize

호출된 파티 설명 필드의 크기(바이트)입니다.

dwCalledPartyOffset

구조체의 시작 부분에서 호출된 파티의 사용자에게 친숙한 설명을 지정하는 고정 크기 필드로 오프셋됩니다. 이 정보는 lineMakeCall 을 사용하여 지정할 수 있으며, 새 호출이 설정될 때마다 lpCallParams 매개 변수에 선택적으로 지정할 수 있습니다. 호출 로깅 용도로 유용합니다. 필드의 크기는 dwCalledPartySize로 지정됩니다.

dwCommentSize

주석 필드의 크기(바이트)입니다.

dwCommentOffset

구조체의 시작 부분에서 lineMakeCall을 사용하여 호출을 시작한 애플리케이션에서 제공한 호출에 대한 주석을 포함하는 고정 크기 필드로 오프셋합니다. 이 정보는 새 호출이 설정될 때마다 lpCallParams 매개 변수에 선택적으로 지정할 수 있습니다. 필드의 크기는 dwCommentSize로 지정됩니다.

dwDisplaySize

원시 디스플레이 정보의 크기(바이트)입니다.

dwDisplayOffset

구조체의 시작 부분에서 원시 표시 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 전화 통신 환경에 따라 서비스 공급자는 이 전화 통신 구성에 가장 적합한 서식 및 프레젠테이션을 위해 이 멤버 쌍에서 기능 정보를 추출할 수 있습니다. 필드의 크기는 dwDisplaySize로 지정됩니다.

dwUserUserInfoSize

사용자-사용자 정보의 크기(바이트)입니다. 사용자-사용자 정보가 문자열에 대한 포인터인 경우 크기에 null 종결자가 포함되어야 합니다.

dwUserUserInfoOffset

구조체의 시작 부분에서 사용자-사용자 정보를 보유하는 고정 크기 필드로 오프셋됩니다. 사용자-사용자 정보에 대한 프로토콜 판별자 필드(사용되는 경우)는 dwUserUserInfoOffset이 가리키는 데이터의 첫 번째 바이트로 표시되며 dwUserUserInfoSize에서 로 간주됩니다.

dwHighLevelCompSize

상위 수준 호환성 정보의 크기(바이트)입니다.

dwHighLevelCompOffset

구조체의 시작 부분에서 높은 수준의 호환성 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 이 정보의 형식은 다른 표준(ISDN Q.931)에 의해 지정됩니다. 필드의 크기는 dwHighLevelCompSize로 지정됩니다.

dwLowLevelCompSize

하위 수준 호환성 정보의 크기(바이트)입니다.

dwLowLevelCompOffset

구조체의 시작 부분에서 낮은 수준의 호환성 정보를 포함하는 고정 크기 필드로 오프셋됩니다. 이 정보의 형식은 다른 표준(ISDN Q.931)에 의해 지정됩니다. 필드의 크기는 dwLowLevelCompSize로 지정됩니다.

dwChargingInfoSize

충전 정보의 크기(바이트)입니다.

dwChargingInfoOffset

구조체의 시작 부분에서 충전 정보를 보유하는 고정 크기 필드로 오프셋됩니다. 이 정보의 형식은 다른 표준(ISDN Q.931)에 의해 지정됩니다. 필드의 크기는 dwChargingInfoSize로 지정됩니다.

dwTerminalModesSize

현재 터미널 모드 배열의 크기(바이트)입니다.

dwTerminalModesOffset

구조체의 시작 부분에서 DWORD 크기 항목이 있는 배열을 포함하는 고정 크기 디바이스 필드로 오프셋합니다. 배열 항목은 0에서 dwNumTerminals보다 작은 범위의 터미널 식별자에 의해 인덱싱됩니다. 배열의 각 항목은 LINETERMMODE_ 상수 중 하나에 지정된 대로 이 호출의 미디어 스트림에 대한 lineSetTerminal 함수를 사용하여 해당 터미널 집합의 현재 터미널 모드 를 지정합니다. 배열의 크기는 dwTerminalModesSize로 지정됩니다.

dwDevSpecificSize

디바이스별 필드의 크기(바이트)입니다.

dwDevSpecificOffset

구조체의 시작 부분에서 디바이스별 정보를 보유하는 고정 크기 필드로 오프셋합니다. 필드의 크기는 dwDevSpecificSize로 지정됩니다.

dwCallTreatment

통화 처리는 현재 호출에 적용되고 있거나 호출이 다음 적용 가능한 상태로 들어갈 때 적용됩니다. 호출 처리가 지원되지 않는 경우 0일 수 있습니다.

dwCallDataSize

애플리케이션 설정 가능 호출 데이터의 크기(바이트)입니다.

dwCallDataOffset

구조체의 시작 부분에서 애플리케이션 설정 가능 호출 데이터로 오프셋합니다. 필드의 크기는 dwCallDataSize로 지정됩니다.

dwSendingFlowspecSize

서비스 정보의 품질 크기(바이트)입니다.

dwSendingFlowspecOffset

구조체의 시작 부분에서 FLOWSPEC 구조로 오프셋한 다음 WinSock 공급자별 데이터(QOS 구조의 SendFlowspec에 저장되었을 데이터)에 해당합니다. 호출의 전송 방향에서 현재 적용되는 서비스 품질을 지정합니다. TAPI는 프라이빗 포인터가 가리키는 데이터를 마샬링하고 애플리케이션에 대한 프로세스 간 통신을 통해 전달하는 방법을 모르기 때문에 FLOWSPEC 구조 다음에 있는 공급자 관련 부분에는 다른 메모리 블록에 대한 포인터가 포함되어서는 안 됩니다. 필드의 크기는 dwSendingFlowspecSize로 지정됩니다.

dwReceivingFlowspecSize

서비스 정보의 품질 크기(바이트)입니다.

dwReceivingFlowspecOffset

구조체의 시작 부분에서 FLOWSPEC 구조로 오프셋한 다음 WinSock 공급자별 데이터(QOS 구조의 ReceivingFlowspec에 저장된 데이터와 동일). 호출의 수신 방향에서 현재 적용되는 서비스 품질을 지정합니다. TAPI는 프라이빗 포인터가 가리키는 데이터를 마샬링하고 애플리케이션에 대한 프로세스 간 통신을 통해 전달하는 방법을 모르기 때문에 FLOWSPEC 구조 다음에 있는 공급자 관련 부분에는 다른 메모리 블록에 대한 포인터가 포함되어서는 안 됩니다. 필드의 크기는 dwReceivingFlowspecSize로 지정됩니다.

dwCallerIDAddressType

호출자의 주소 유형입니다. 이 구조체 멤버는 협상된 TAPI 버전이 3.0 이상인 경우에만 사용할 수 있습니다.

dwCalledIDAddressType

호출된 파티의 주소 유형입니다. 이 구조체 멤버는 협상된 TAPI 버전이 3.0 이상인 경우에만 사용할 수 있습니다.

dwConnectedIDAddressType

호출이 실제로 연결된 대상의 주소 유형입니다. 이 구조체 멤버는 협상된 TAPI 버전이 3.0 이상인 경우에만 사용할 수 있습니다.

dwRedirectionIDAddressType

새 호출 대상의 주소 유형입니다. 이 구조체 멤버는 협상된 TAPI 버전이 3.0 이상인 경우에만 사용할 수 있습니다.

dwRedirectingIDAddressType

호출을 리디렉션한 위치의 주소 유형입니다. 이 구조체 멤버는 협상된 TAPI 버전이 3.0 이상인 경우에만 사용할 수 있습니다.

설명

디바이스별 확장은 이 데이터 구조의 고정 크기 영역인 DevSpecific(dwDevSpecificSizedwDevSpecificOffset)을 사용해야 합니다.

LINECALLINFO 데이터 구조에는 호출에 대한 비교적 고정된 정보가 포함되어 있습니다. 이 구조체는 lineGetCallInfo와 함께 반환됩니다. 이 데이터 구조의 정보 항목이 변경되면 LINE_CALLINFO 메시지가 애플리케이션으로 전송됩니다. 이 메시지에 대한 매개 변수는 변경된 정보 항목 또는 필드입니다.

dwReceivingFlowspecOffset을 통한 dwCallTreatment 멤버는 API 버전이 2.0 이상인 라인 디바이스를 여는 애플리케이션에서만 사용할 수 있습니다.

참고dwCallID 필드 및 기타 5개의 유사한 필드(dwCallerIDFlag, dwCallerIDSize, dwCallerIDOffset, dwCallerIDNameSize 및 dwCallerIDNameOffset)의 사양에 대한 기본 형식은 TAPI 정식 번호 형식입니다. 예를 들어 LINECALLINFO 구조체에 배치되기 전에 스위치에서 받은 "4258828080"의 ICLID를 "+1(425) 8828080"으로 변환해야 합니다. 이 표준화된 형식은 애플리케이션에서 구현된 데이터베이스 및 콜백 함수를 쉽게 검색할 수 있도록 합니다.
 

요구 사항

요구 사항
헤더 tapi.h

추가 정보

LINECALLSTATUS

LINEDEVCAPS

LINEDIALPARAMS

LINETRANSLATEOUTPUT

LINE_CALLINFO

LINE_MONITORMEDIA

TSPI_lineGetCallInfo

lineGenerateDigits

lineGetCallInfo

lineGetCallStatus

lineInitializeEx

lineMakeCall

lineSecureCall

lineSetAppSpecific

lineSetCallParams

lineSetTerminal

lineTranslateAddress