Share via

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