LINEADDRESSCAPS 구조체(tapi.h)
LINEADDRESSCAPS 구조체는 지정된 주소의 기능을 설명합니다. lineGetAddressCaps 함수와 TSPI_lineGetAddressCaps 함수는 LINEADDRESSCAPS 구조를 반환합니다.
구문
typedef struct lineaddresscaps_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwLineDeviceID;
DWORD dwAddressSize;
DWORD dwAddressOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwAddressSharing;
DWORD dwAddressStates;
DWORD dwCallInfoStates;
DWORD dwCallerIDFlags;
DWORD dwCalledIDFlags;
DWORD dwConnectedIDFlags;
DWORD dwRedirectionIDFlags;
DWORD dwRedirectingIDFlags;
DWORD dwCallStates;
DWORD dwDialToneModes;
DWORD dwBusyModes;
DWORD dwSpecialInfo;
DWORD dwDisconnectModes;
DWORD dwMaxNumActiveCalls;
DWORD dwMaxNumOnHoldCalls;
DWORD dwMaxNumOnHoldPendingCalls;
DWORD dwMaxNumConference;
DWORD dwMaxNumTransConf;
DWORD dwAddrCapFlags;
DWORD dwCallFeatures;
DWORD dwRemoveFromConfCaps;
DWORD dwRemoveFromConfState;
DWORD dwTransferModes;
DWORD dwParkModes;
DWORD dwForwardModes;
DWORD dwMaxForwardEntries;
DWORD dwMaxSpecificEntries;
DWORD dwMinFwdNumRings;
DWORD dwMaxFwdNumRings;
DWORD dwMaxCallCompletions;
DWORD dwCallCompletionConds;
DWORD dwCallCompletionModes;
DWORD dwNumCompletionMessages;
DWORD dwCompletionMsgTextEntrySize;
DWORD dwCompletionMsgTextSize;
DWORD dwCompletionMsgTextOffset;
DWORD dwAddressFeatures;
DWORD dwPredictiveAutoTransferStates;
DWORD dwNumCallTreatments;
DWORD dwCallTreatmentListSize;
DWORD dwCallTreatmentListOffset;
DWORD dwDeviceClassesSize;
DWORD dwDeviceClassesOffset;
DWORD dwMaxCallDataSize;
DWORD dwCallFeatures2;
DWORD dwMaxNoAnswerTimeout;
DWORD dwConnectedModes;
DWORD dwOfferingModes;
DWORD dwAvailableMediaModes;
} LINEADDRESSCAPS, *LPLINEADDRESSCAPS;
멤버
dwTotalSize
이 데이터 구조에 할당된 총 크기(바이트)입니다.
dwNeededSize
반환된 모든 정보를 바이트 단위로 유지하는 데 필요한 이 데이터 구조의 크기입니다.
dwUsedSize
유용한 정보를 포함하는 이 데이터 구조의 부분 크기(바이트)입니다.
dwLineDeviceID
이 주소가 연결된 줄 디바이스의 디바이스 식별자입니다.
dwAddressSize
주소 필드의 크기(바이트)입니다.
dwAddressOffset
구조체의 시작 부분에서 고정 크기 주소 필드로 오프셋됩니다. 필드의 크기는 dwAddressSize로 지정됩니다.
dwDevSpecificSize
디바이스별 필드의 크기(바이트)입니다.
dwDevSpecificOffset
구조체의 시작 부분에서 변함없이 크기가 조정된 디바이스별 필드로 오프셋됩니다. 필드의 크기는 dwDevSpecificSize로 지정됩니다.
dwAddressSharing
주소의 공유 모드입니다. 이 멤버는 LINEADDRESSSHARING_ 상수 중 하나일 수 있습니다.
dwAddressStates
애플리케이션이 LINE_ADDRESSSTATE 메시지에서 알림을 받을 수 있는 상태 변경 내용을 처리합니다. 이 멤버는 하나 이상의 LINEADDRESSSTATE_ 상수를 사용합니다.
dwCallInfoStates
이 주소의 모든 호출에 의미 있는 호출 정보 요소입니다. 애플리케이션은 LINE_CALLINFO 메시지에서 이러한 상태 중 일부의 변경 내용에 대한 알림을 받을 수 있습니다. 이 멤버는 하나 이상의 LINECALLINFOSTATE_ 상수를 사용합니다.
dwCallerIDFlags
이 주소의 호출에 대해 제공할 수 있는 파티 식별자 정보 유형입니다. 호출자는 세션의 생성자입니다. 하나 이상의 LINECALLPARTYID_ 상수입니다.
dwCalledIDFlags
이 주소의 호출에 대해 제공할 수 있는 파티 식별자 정보 유형입니다. 여기서 "호출"은 원래 대상을 나타냅니다. 하나 이상의 LINECALLPARTYID_ 상수입니다.
dwConnectedIDFlags
이 주소의 호출에 대해 제공할 수 있는 파티 식별자 정보 유형입니다. 하나 이상의 LINECALLPARTYID_ 상수입니다.
dwRedirectionIDFlags
이 주소의 호출에 대해 제공할 수 있는 파티 식별자 정보 유형입니다. 여기서 "리디렉션"은 새 대상입니다. 하나 이상의 LINECALLPARTYID_ 상수입니다.
dwRedirectingIDFlags
이 주소의 호출에 대해 제공할 수 있는 파티 식별자 정보 유형입니다. 여기서 "리디렉션"은 리디렉션을 호출한 주소입니다. 하나 이상의 LINECALLPARTYID_ 상수입니다.
dwCallStates
이 주소의 호출에 대해 보고할 수 있는 호출 상태입니다. 이 멤버는 하나 이상의 LINECALLSTATE_ 상수를 사용합니다.
dwDialToneModes
이 주소에서 발생한 호출에 대해 보고할 수 있는 다이얼 톤 모드입니다. 이 멤버는 다이얼톤 호출 상태를 보고할 수 있는 경우에만 의미가 있습니다. 이 멤버는 하나 이상의 LINEDIALTONEMODE_ 상수를 사용합니다.
dwBusyModes
이 주소에서 수행된 호출에 대해 보고할 수 있는 사용 중인 모드입니다. 이 멤버는 사용 중인 호출 상태를 보고할 수 있는 경우에만 의미가 있습니다. 이 멤버는 하나 이상의 LINEBUSYMODE_ 상수를 사용합니다.
dwSpecialInfo
이 주소에서 수행된 호출에 대해 보고할 수 있는 특수 정보 유형입니다. 이 멤버는 specialInfo 호출 상태를 보고할 수 있는 경우에만 의미가 있습니다. 이 멤버는 하나 이상의 LINESPECIALINFO_ 상수를 사용합니다.
dwDisconnectModes
이 주소에서 수행된 호출에 대해 보고할 수 있는 연결 끊기 모드입니다. 이 멤버는 연결이 끊긴 호출 상태를 보고할 수 있는 경우에만 의미가 있습니다. 이 멤버는 하나 이상의 LINEDISCONNECTMODE_ 상수를 사용합니다.
dwMaxNumActiveCalls
주소가 처리할 수 있는 최대 활성 호출 모양 수입니다. 이 번호에는 보류 중인 통화 또는 보류 중인 전송 또는 회의 통화가 포함되지 않습니다.
dwMaxNumOnHoldCalls
대기할 수 있는 주소의 최대 통화 표시 수입니다.
dwMaxNumOnHoldPendingCalls
보류 중인 전송 또는 회의를 보류할 수 있는 주소의 최대 통화 표시 수입니다.
dwMaxNumConference
이 주소에서 단일 전화 회의에 참가할 수 있는 최대 당사자 수입니다.
dwMaxNumTransConf
lineSetupTransfer를 사용하여 일반 상담 통화로 시작되는 전화 회의에 추가할 수 있는 당사자 수("자체"포함)입니다.
dwAddrCapFlags
다양한 주소 기능을 설명하는 압축된 비트 플래그입니다. 이 멤버는 하나 이상의 LINEADDRCAPFLAGS_ 상수를 사용합니다.
dwCallFeatures
LINECALLFEATURE_ 상수를 사용하여 이 주소의 모든 호출에 사용할 수 있는 기능 또는 기능을 전환합니다. 이 멤버는 주소에서 사용할 수 있는 호출 관련 기능을 나타냅니다(동적 가용성이 아닌 정적 가용성). 지원되는 기능을 호출하려면 호출이 적절한 상태여야 하고 기본 라인 디바이스를 호환 모드로 열어야 합니다. 비트 위치의 0은 해당 기능을 사용할 수 없음을 나타냅니다. 하나는 애플리케이션이 호출에 대한 올바른 권한을 가지고 있고 호출이 작업이 의미 있는 적절한 상태에 있는 경우 해당 기능을 사용할 수 있음을 나타냅니다. 이 멤버를 사용하면 애플리케이션이 주소에서 지원될 수 있는 호출 기능을 검색할 수 있습니다(그리고 결코 지원될 수 없음).
dwRemoveFromConfCaps
전화 회의에서 통화를 제거하기 위한 주소의 기능입니다. 이 멤버는 LINEREMOVEFROMCONF_ 상수 중 하나를 사용합니다.
dwRemoveFromConfState
LINECALLSTATE_ 상수를 사용하여 전화 회의에서 호출이 제거된 후의 호출 상태를 지정합니다.
dwTransferModes
전송 요청을 해결하기 위한 주소의 기능입니다. 이 멤버는 LINETRANSFERMODE_ 상수 중 하나를 사용합니다.
dwParkModes
이 주소에서 사용할 수 있는 다양한 통화 대기 모드입니다. 이 멤버는 LINEPARKMODE_ 상수 중 하나를 사용합니다.
dwForwardModes
이 주소에 사용할 수 있는 전달 모드가 다릅니다. 이 멤버는 LINEFORWARDMODE_ 상수를 사용합니다.
dwMaxForwardEntries
lpForwardList 매개 변수에서 lineForward에 전달할 수 있는 최대 항목 수입니다.
dwMaxSpecificEntries
특정 호출자 ID(선택적 착신 전환)에 따라 전달 지침을 포함할 수 있는 lineForward에 전달된 lpForwardList 매개 변수의 최대 항목 수입니다. 선택적 착신 전환이 지원되지 않는 경우 이 멤버는 0입니다.
dwMinFwdNumRings
통화가 공식적으로 "응답 없음"으로 간주되는 시기를 결정하도록 설정할 수 있는 최소 링 수입니다.
dwMaxFwdNumRings
통화가 공식적으로 "응답 없음"으로 간주되는 시기를 결정하기 위해 설정할 수 있는 최대 링 수입니다. 이 링 수를 설정할 수 없는 경우 dwMinFwdNumRings 및 dwMaxNumRings 가 같습니다.
dwMaxCallCompletions
이 회선 디바이스에서 미해결 상태일 수 있는 최대 동시 호출 완료 요청 수입니다. 0은 호출 완료를 사용할 수 없음을 의미합니다.
dwCallCompletionConds
호출 완료를 요청할 수 있는 다양한 호출 조건입니다. 이 멤버는 하나 이상의 LINECALLCOMPLCOND_ 상수를 사용합니다.
dwCallCompletionModes
호출을 완료할 수 있는 방법입니다. 이 멤버는 LINECALLCOMPLMODE_ 상수 중 하나를 사용합니다.
dwNumCompletionMessages
LINECALLCOMPLMODE_MESSAGE 옵션을 사용할 때 선택할 수 있는 호출 완료 메시지 수입니다. 개별 메시지는 dwNumCompletionMessages보다 작은 0부터 범위의 값으로 식별됩니다.
dwCompletionMsgTextEntrySize
dwCompletionMsgTextSize 및 dwCompletionMsgTextOffset에 의해 지정된 각 호출 완료 텍스트 설명의 크기(바이트)입니다.
dwCompletionMsgTextSize
호출 완료 텍스트의 크기(바이트)입니다.
dwCompletionMsgTextOffset
이 데이터 구조의 시작 부분에서 각 호출 완료 메시지에 대한 설명 텍스트를 포함하는 고정 크기 필드로 오프셋됩니다. 각 메시지는 dwCompletionMsgTextEntrySize 바이트 길이입니다. 이러한 텍스트 설명의 문자열 형식은 줄의 디바이스 기능에서 dwStringFormat 으로 표시됩니다. 필드의 크기는 dwCompletionMsgTextSize로 지정됩니다.
dwAddressFeatures
LINEADDRFEATURE_ 상수를 사용하여 이 주소에 사용할 수 있는 기능입니다. 지원되는 기능을 호출하려면 주소가 적절한 상태여야 하고 기본 줄 디바이스를 호환 모드로 열어야 합니다. 비트 위치의 0은 해당 기능을 사용할 수 없음을 나타냅니다. 하나는 주소가 작업이 의미 있는 적절한 상태에 있는 경우 해당 기능을 사용할 수 있음을 나타냅니다. 이 멤버를 사용하면 애플리케이션이 주소에서 지원될 수 있는 주소 기능을 검색할 수 있습니다( 그리고 결코 지원될 수 없음).
dwPredictiveAutoTransferStates
호출 상태 또는 예측 전화 걸기를 통해 호출을 설정하여 호출을 다른 주소로 자동으로 전송할 수 있는 상태 LINECALLSTATE_ 상수 중 하나 이상 값 0은 호출 상태에 따라 자동 전송을 사용할 수 없음을 나타냅니다.
dwNumCallTreatments
dwCallTreatmentListSize 및 dwCallTreatmentListOffset로 구분된 LINECALLTREATMENTENTRY 구조 배열의 항목 수입니다.
dwCallTreatmentListSize
호출 처리 배열의 크기(바이트)입니다.
dwCallTreatmentListOffset
구조체의 시작 부분에서 LINECALLTREATMENTENTRY 구조의 배열로 오프셋은 주소에서 지원되는 호출 처리를 지정합니다( lineSetCallTreatment를 사용하여 선택할 수 있음). 값은 dwNumCallTreatments times SIZEOF(LINECALLTREATMENTENTRY)입니다. 필드의 크기는 dwCallTreatmentListSize로 지정됩니다.
dwDeviceClassesSize
지원되는 디바이스 클래스 목록의 크기(바이트)입니다.
dwDeviceClassesOffset
구조체의 시작 부분에서 lineGetID와 함께 사용하기 위해 이 주소에서 지원되는 디바이스 클래스 식별자로 구성된 문자열로 오프셋됩니다. 요소는 null 문자로 구분되고 마지막 클래스 식별자에는 두 개의 null 문자가 잇습니다. 필드의 크기는 dwDeviceClassesSize로 지정됩니다.
dwMaxCallDataSize
lineSetCallData를 사용하여 애플리케이션이 LINECALLINFO에서 설정할 수 있는 최대 바이트 수입니다.
dwCallFeatures2
LINECALLFEATURE2_ 상수를 사용하여 이 주소의 모든 호출에 사용할 수 있는 추가 전환 기능 또는 기능입니다. dwCallFeatures 멤버의 확장입니다.
dwMaxNoAnswerTimeout
호출할 때 LINECALLPARAMS의 dwNoAnswerTimeout 멤버에서 설정할 수 있는 최대값(초)입니다. 값 0은 응답되지 않은 호출의 자동 중단이 서비스 공급자에서 지원되지 않거나 애플리케이션에서 시간 제한 값을 조정할 수 없음을 나타냅니다.
dwConnectedModes
LINECALLSTATUS의 dwCallStateMode 멤버 및 이 주소의 호출에 대한 LINE_CALLSTATE 메시지에 표시할 수 있는 값을 LINECONNECTEDMODE_.
dwOfferingModes
LINECALLSTATUS의 dwCallStateMode 멤버 및 이 주소의 호출에 대한 LINE_CALLSTATE 메시지에 표시할 수 있는 값을 LINEOFFERINGMODE_.
dwAvailableMediaModes
dwAddressFeatures 멤버가 새 호출이 가능하다는 것을 나타내는 경우 이 주소에서 만든 새 호출에서 호출할 수 있는 미디어 유형(모드)입니다. 이 멤버가 0이면 서비스 공급자가 사용할 수 있는 미디어 형식을 모르거나 나타낼 수 없음을 나타냅니다. 이 경우 LINEDEVCAPS의 dwMediaModes 멤버에 표시된 미디어 형식 중 하나 또는 전부를 사용할 수 있습니다.
설명
디바이스별 확장은 이 데이터 구조의 고정 크기 영역인 DevSpecific (dwDevSpecificSize 및 dwDevSpecificOffset)을 사용해야 합니다.
이전 애플리케이션은 LINEADDRESSCAPS 구조에서 이 멤버 없이 컴파일되고 새 크기보다 작은 SIZEOF(LINEADDRESSCAPS)를 사용합니다. 애플리케이션은 이 상황을 처리하는 데 TAPI의 지침에 사용할 수 있는 lineGetAddressCaps 함수를 사용하여 dwAPIVersion 매개 변수를 전달합니다. 애플리케이션이 지정된 dwAPIVersion 멤버에 정의된 구조체의 고정 부분 크기보다 작은 dwTotalSize 멤버에 전달되면 LINEERR_STRUCTURETOOSMALL 반환됩니다. 애플리케이션에서 충분한 메모리를 할당한 경우 TSPI_lineGetAddressCaps 호출하기 전에 TAPI는 dwNeededSize 및 dwUsedSize 멤버를 지정된 API 버전에 있는 구조체의 고정 크기로 설정합니다.
새 서비스 공급자(새 API 버전을 지원)는 전달된 API 버전을 검사해야 합니다. API 버전이 공급자에서 지원하는 가장 높은 버전보다 작은 경우 서비스 공급자는 이전 구조의 변수 부분에 해당하므로 이전 API 버전에서 지원되지 않는 필드를 채우지 않아야 합니다.
새 애플리케이션은 협상된 API 버전을 인식해야 하며 협상된 API 버전에 대한 구조체의 고정 부분의 원래 끝을 벗어나는 고정 부분의 필드 내용을 검사하지 않아야 합니다.
dwAvailableMediaModes를 통한 dwPredictiveAutoTransferStates 멤버는 lineGetAddressCaps를 호출할 때 API 버전 2.0 이상을 요청하는 애플리케이션에서만 사용할 수 있습니다.
요구 사항
| 머리글 | tapi.h |