функция TSPI_lineGetCallInfo (tspi.h)
Функция TSPI_lineGetCallInfo возвращает подробные сведения об указанном вызове.
Синтаксис
LONG TSPIAPI TSPI_lineGetCallInfo(
HDRVCALL hdCall,
LPLINECALLINFO lpCallInfo
);
Параметры
hdCall
Дескриптор поставщика услуг для вызова, сведения о вызове которого необходимо извлечь. Состояние вызова hdCall может быть любым.
lpCallInfo
Указатель на структуру данных изменчивого размера типа LINECALLINFO. После успешного выполнения запроса эта структура заполняется сведениями, связанными с вызовами.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL LINEERR_OPERATIONUNAVAIL.
Комментарии
В следующей таблице показано, какие элементы структуры данных LINECALLINFO заполняются TAPI, а какие — поставщиком услуг. Поставщик услуг должен сохранять (не перезаписывать) значения, заполненные TAPI.
| Имя участника | TAPI | Поставщик службы |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededEdSize; | 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 задает член dwCallStates структуры LINECALLINFO следующим образом:
LINECALLINFO.dwCallStates |= LINECALLSTATE_UNKNOWN;
Если поставщик услуг моделирует строки как "пулы" ресурсов канала и выполняет обратное мультиплексирование вызова по нескольким идентификаторам адресов, он должен последовательно выбрать один из этих идентификаторов адресов в качестве основного идентификатора, сообщаемого этой функцией в структуре данных LINECALLINFO .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |