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 データ構造でこの関数によって報告されるプライマリ識別子として、これらのアドレス識別子の 1 つを一貫して選択する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |