다음을 통해 공유

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