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 구조체의 dwDisplayableAddressSize 및 dwDisplayableAddressOffset 멤버에서 이 필드에 배치할 적절한 정보를 반환합니다.
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(dwDevSpecificSize 및 dwDevSpecificOffset)을 사용해야 합니다.
LINECALLINFO 데이터 구조에는 호출에 대한 비교적 고정된 정보가 포함되어 있습니다. 이 구조체는 lineGetCallInfo와 함께 반환됩니다. 이 데이터 구조의 정보 항목이 변경되면 LINE_CALLINFO 메시지가 애플리케이션으로 전송됩니다. 이 메시지에 대한 매개 변수는 변경된 정보 항목 또는 필드입니다.
dwReceivingFlowspecOffset을 통한 dwCallTreatment 멤버는 API 버전이 2.0 이상인 라인 디바이스를 여는 애플리케이션에서만 사용할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | tapi.h |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기