TSPI_lineGetCallInfo 함수(tspi.h)
TSPI_lineGetCallInfo 함수는 지정된 호출에 대한 자세한 정보를 반환합니다.
구문
LONG TSPIAPI TSPI_lineGetCallInfo(
HDRVCALL hdCall,
LPLINECALLINFO lpCallInfo
);
매개 변수
hdCall
호출 정보를 검색할 호출에 대한 서비스 공급자의 핸들입니다. hdCall의 호출 상태는 모든 상태일 수 있습니다.
lpCallInfo
LINECALLINFO 형식의 고정 크기 데이터 구조에 대한 포인터입니다. 요청이 성공적으로 완료되면 이 구조는 호출 관련 정보로 채워집니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
설명
다음 표에서는 TAPI로 채워진 LINECALLINFO 데이터 구조의 멤버와 서비스 공급자가 채우는 멤버를 나타냅니다. 서비스 공급자는 TAPI로 채워진 값을 보존해야 합니다(덮어쓰지 않아야 합니다).
| 멤버 이름 | Tapi | 서비스 공급자 |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| hLine; | X | |
| dwLineDeviceID; | X | |
| dwAddressID; | X | |
| dwBearerMode; | X | |
| dwRate; | X | |
| dwMediaMode; | X | |
| dwAppSpecific; | X | |
| dwCallID; | X | |
| dwRelatedCallID; | X | |
| dwCallParamFlags; | X | |
| dwCallStates; | X | X |
| dwMonitorDigitModes; | X | |
| dwMonitorMediaModes; | X | |
| DialParams; | X | |
| dwOrigin; | X | |
| dwReason; | X | |
| dwCompletionID; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwCountryCode; | X | |
| dwTrunk; | X | |
| dwCallerIDFlags; | X | |
| dwCallerIDSize; | X | |
| dwCallerIDOffset; | X | |
| dwCallerIDNameSize; | X | |
| dwCallerIDNameOffset; | X | |
| dwCalledIDFlags; | X | |
| dwCalledIDSize; | X | |
| dwCalledIDOffset; | X | |
| dwCalledIDNameSize; | X | |
| dwCalledIDNameOffset; | X | |
| dwConnectedIDFlags; | X | |
| dwConnectedIDSize; | X | |
| dwConnectedIDOffset; | X | |
| dwConnectedIDNameSize; | X | |
| dwConnectedIDNameOffset; | X | |
| dwRedirectionIDFlags; | X | |
| dwRedirectionIDSize; | X | |
| dwRedirectionIDOffset; | X | |
| dwRedirectionIDNameSize; | X | |
| dwRedirectionIDNameOffset; | X | |
| dwRedirectingIDFlags; | X | |
| dwRedirectingIDSize; | X | |
| dwRedirectingIDOffset; | X | |
| dwRedirectingIDNameSize; | X | |
| dwRedirectingIDNameOffset; | X | |
| dwAppNameSize; | X | |
| dwAppNameOffset; | X | |
| dwDisplayableAddressSize; | X | |
| dwDisplayableAddressOffset; | X | |
| dwCalledPartySize; | X | |
| dwCalledPartyOffset; | X | |
| dwCommentSize; | X | |
| dwCommentOffset; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwUserUserInfoSize; | X | |
| dwUserUserInfoOffset; | X | |
| dwHighLevelCompSize; | X | |
| dwHighLevelCompOffset; | X | |
| dwLowLevelCompSize; | X | |
| dwLowLevelCompOffset; | X | |
| dwChargingInfoSize; | X | |
| dwChargingInfoOffset; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI는 dwAppNameSize/Offset, dwCalledPartySize/Offset 및 dwCommentSize/Offset 멤버의 크기 및 오프셋 필드를 채우고 서비스 공급자를 호출한 후 이를 반영하도록 dwUsedSize 의 값을 업데이트합니다.
서비스 공급자가 TSPI_lineGetCallInfo 함수에서 반환된 후 TAPI는 LINECALLINFO 구조체의 dwCallStates 멤버를 다음과 같이 설정합니다.
LINECALLINFO.dwCallStates |= LINECALLSTATE_UNKNOWN;
서비스 공급자가 채널 리소스의 "풀"로 줄을 모델링하고 여러 주소 식별자에 대한 호출의 역 멀티플렉싱을 수행하는 경우 LINECALLINFO 데이터 구조에서 이 함수에서 보고한 기본 식별자로 이러한 주소 식별자 중 하나를 일관되게 선택해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |