LINECALLINFO 構造体 (tapi.h)
LINECALLINFO 構造体には、呼び出しに関する情報が含まれています。 この情報は、呼び出しの間は比較的固定されたままです。 複数の関数 で LINECALLINFO が使用されます。 構造体は、 lineGetCallInfo 関数と TSPI_lineGetCallInfo 関数によって返されます。 構造体の一部が変更されると、変更された情報項目を示す LINE_CALLINFO メッセージがアプリケーションに送信されます。
呼び出しの進行状況など、呼び出しに関する情報を動的に変更することは、 lineGetCallStatus 関数の呼び出しによって返される LINECALLSTATUS 構造体で使用できます。
構文
typedef struct linecallinfo_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
HLINE hLine;
DWORD dwLineDeviceID;
DWORD dwAddressID;
DWORD dwBearerMode;
DWORD dwRate;
DWORD dwMediaMode;
DWORD dwAppSpecific;
DWORD dwCallID;
DWORD dwRelatedCallID;
DWORD dwCallParamFlags;
DWORD dwCallStates;
DWORD dwMonitorDigitModes;
DWORD dwMonitorMediaModes;
LINEDIALPARAMS DialParams;
DWORD dwOrigin;
DWORD dwReason;
DWORD dwCompletionID;
DWORD dwNumOwners;
DWORD dwNumMonitors;
DWORD dwCountryCode;
DWORD dwTrunk;
DWORD dwCallerIDFlags;
DWORD dwCallerIDSize;
DWORD dwCallerIDOffset;
DWORD dwCallerIDNameSize;
DWORD dwCallerIDNameOffset;
DWORD dwCalledIDFlags;
DWORD dwCalledIDSize;
DWORD dwCalledIDOffset;
DWORD dwCalledIDNameSize;
DWORD dwCalledIDNameOffset;
DWORD dwConnectedIDFlags;
DWORD dwConnectedIDSize;
DWORD dwConnectedIDOffset;
DWORD dwConnectedIDNameSize;
DWORD dwConnectedIDNameOffset;
DWORD dwRedirectionIDFlags;
DWORD dwRedirectionIDSize;
DWORD dwRedirectionIDOffset;
DWORD dwRedirectionIDNameSize;
DWORD dwRedirectionIDNameOffset;
DWORD dwRedirectingIDFlags;
DWORD dwRedirectingIDSize;
DWORD dwRedirectingIDOffset;
DWORD dwRedirectingIDNameSize;
DWORD dwRedirectingIDNameOffset;
DWORD dwAppNameSize;
DWORD dwAppNameOffset;
DWORD dwDisplayableAddressSize;
DWORD dwDisplayableAddressOffset;
DWORD dwCalledPartySize;
DWORD dwCalledPartyOffset;
DWORD dwCommentSize;
DWORD dwCommentOffset;
DWORD dwDisplaySize;
DWORD dwDisplayOffset;
DWORD dwUserUserInfoSize;
DWORD dwUserUserInfoOffset;
DWORD dwHighLevelCompSize;
DWORD dwHighLevelCompOffset;
DWORD dwLowLevelCompSize;
DWORD dwLowLevelCompOffset;
DWORD dwChargingInfoSize;
DWORD dwChargingInfoOffset;
DWORD dwTerminalModesSize;
DWORD dwTerminalModesOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwCallTreatment;
DWORD dwCallDataSize;
DWORD dwCallDataOffset;
DWORD dwSendingFlowspecSize;
DWORD dwSendingFlowspecOffset;
DWORD dwReceivingFlowspecSize;
DWORD dwReceivingFlowspecOffset;
DWORD dwCallerIDAddressType;
DWORD dwCalledIDAddressType;
DWORD dwConnectedIDAddressType;
DWORD dwRedirectionIDAddressType;
DWORD dwRedirectingIDAddressType;
} LINECALLINFO, *LPLINECALLINFO;
メンバー
dwTotalSize
このデータ構造に割り当てられた合計サイズ (バイト単位)。
dwNeededSize
返されるすべての情報をバイト単位で保持するために必要な、このデータ構造のサイズ。
dwUsedSize
有用な情報を含むこのデータ構造の部分のサイズ (バイト単位)。
hLine
この呼び出しが関連付けられている回線デバイスを処理します。
dwLineDeviceID
この呼び出しが関連付けられている回線デバイスのデバイス識別子。
dwAddressID
この呼び出しが存在する行のアドレスのアドレス識別子。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード全体で一定のままです。
dwBearerMode
呼び出しの現在のベアラー モード。 このメンバーは、 LINEBEARERMODE_定数のいずれかを使用します。
dwRate
呼び出しのデータ ストリームのレート (bps (ビット/秒)。
dwMediaMode
現在呼び出し中の情報ストリームのメディアの種類。 これは、呼び出しの所有者によって決定されるメディアの種類です。これは、必ずしも最後の LINE_MONITORMEDIA メッセージと同じとは限りません。 このメンバーは、LINE_MONITORMEDIA メッセージの影響を直接受けられません。 このメンバーは 、LINEMEDIAMODE_定数を使用します。
dwAppSpecific
API 実装とサービス プロバイダーでは解釈されません。 lineSetAppSpecific 関数を使用して、この呼び出しの任意の所有者アプリケーションで設定できます。
dwCallID
一部のテレフォニー環境では、スイッチまたはサービス プロバイダーは、各呼び出しに一意の識別子を割り当てることができます。 これにより、転送、転送、またはその他のイベント間で呼び出しを追跡できます。 これらの呼び出し ID とそのスコープのドメインは、サービス プロバイダー定義です。 dwCallID メンバーは、この一意識別子をアプリケーションで使用できるようにします。
dwRelatedCallID
通話 ID を使用するテレフォニー環境では、多くの場合、1 つの呼び出しを別の通話に関連付ける必要がある場合があります。 dwRelatedCallID メンバーは、この目的のためにサービス プロバイダーによって使用される場合があります。
dwCallParamFlags
呼び出しが発信される場合の呼び出し関連パラメーターのコレクション。 これらは、 lineMakeCall で指定されたのと同じ呼び出しパラメーターであり、 LINECALLPARAMFLAGS_定数の 1 つ以上です。
dwCallStates
この呼び出しでアプリケーションに通知できる状態を示す 1 つ以上のLINECALLSTATE_定数。 dwCallStates メンバーは LINECALLINFO では定数であり、呼び出し状態によっては変更されません。
dwMonitorDigitModes
さまざまな数字モード。 このメンバーは、監視が現在有効になっている 1 つ以上の LINEDIGITMODE_定数です。
dwMonitorMediaModes
監視が現在有効になっているさまざまなメディアの種類。 このメンバーは、 LINEMEDIAMODE_定数の 1 つ以上です。
DialParams
現在、呼び出しで有効になっている、 種類が LINEDIALPARAMS のダイヤル パラメーター。 これらのパラメーターが lineMakeCall または lineSetCallParams によって設定されていない限り、それらの値は LINEDEVCAPS 構造体で使用される既定値と同じです。
dwOrigin
呼び出しが発生した場所を識別します。 このメンバーには、 LINECALLORIGIN_定数のいずれかを指定できます。
dwReason
呼び出しが発生した理由。 このメンバーには、 LINECALLREASON_定数のいずれかを指定できます。
dwCompletionID
着信呼び出しが終了する完了要求の結果である場合の完了識別子。 この識別子は、 dwReason がLINECALLREASON_CALLCOMPLETIONされている場合にのみ意味があります。
dwNumOwners
呼び出しに対する所有者特権を持つ異なる呼び出しハンドルを持つアプリケーション モジュールの数。
dwNumMonitors
呼び出しに対するモニター特権を持つ異なる呼び出しハンドルを持つアプリケーション モジュールの数。
dwCountryCode
宛先パーティの国または地域コード。 不明な場合は 0。
dwTrunk
呼び出しがルーティングされるトランクの番号。 このメンバーは、着信呼び出しと発信呼び出しの両方に使用されます。 dwTrunk メンバーが不明な場合は、0xFFFFFFFFに設定する必要があります。
dwCallerIDFlags
呼び出し元または発信元のパーティ識別子情報の有効性と内容を決定します。 このメンバーは、 LINECALLPARTYID_定数のいずれかを使用します。
dwCallerIDSize
呼び出し元 ID 番号のサイズ (バイト単位)。
dwCallerIDOffset
この構造体の先頭から、呼び出し元のパーティ ID 番号情報を含む可変サイズのフィールドへのオフセット。 フィールドのサイズは dwCallerIDSize によって指定されます。
dwCallerIDNameSize
null ターミネータを含む呼び出し元 ID 名のサイズ (バイト単位)。
dwCallerIDNameOffset
この構造体の先頭から、呼び出し元のパーティ ID 名情報を含む可変サイズのフィールドへのオフセット。 フィールドのサイズは dwCallerIDNameSize によって指定されます。
dwCalledIDFlags
呼び出し側 ID 情報の有効性と内容を決定します。 呼び出されたパーティは、最初にアドレス指定されたパーティに対応します。 このメンバーは、 LINECALLPARTYID_定数のいずれかを使用します。
dwCalledIDSize
呼び出し側 ID 番号のサイズ (バイト単位)。
dwCalledIDOffset
構造体の先頭から、呼び出し側 ID 番号情報を含む可変サイズのフィールドへのオフセット。 フィールドのサイズは dwCalledIDSize によって指定されます。
dwCalledIDNameSize
null ターミネータを含む、呼び出し先 ID 名のサイズ (バイト単位)。
dwCalledIDNameOffset
構造体の先頭から、呼び出し側 ID 名情報を含む可変サイズのフィールドへのオフセット。 フィールドのサイズは dwCalledIDNameSize によって指定されます。
dwConnectedIDFlags
接続されたパーティ ID 情報の有効性と内容を決定します。 接続されたパーティは、実際に接続されたパーティです。 呼び出しが転送された場合、これは呼び出し側 ID とは異なる場合があります。 このメンバーは、 LINECALLPARTYID_定数のいずれかを使用します。
dwConnectedIDSize
接続されたパーティ ID 番号のサイズ (バイト単位)。
dwConnectedIDOffset
この構造体の先頭から、接続パーティ ID 番号情報を含む可変サイズのフィールドへのオフセット。 フィールドのサイズは dwConnectedIDSize によって指定されます。
dwConnectedIDNameSize
null ターミネータを含む接続パーティ ID 名のサイズ (バイト単位)。
dwConnectedIDNameOffset
この構造体の先頭から、接続パーティ ID 名情報を含む可変サイズのフィールドへのオフセット。 フィールドのサイズは dwConnectedIDNameSize によって指定されます。
dwRedirectionIDFlags
リダイレクト パーティ識別子情報の有効性と内容を決定します。 リダイレクト パーティは、セッションがリダイレクトされたアドレスを識別します。 このメンバーは、 LINECALLPARTYID_定数のいずれかを使用します。
dwRedirectionIDSize
リダイレクト パーティ ID 番号のサイズ (バイト単位)。
dwRedirectionIDOffset
構造体の先頭から、リダイレクトパーティ ID 番号情報を含む可変サイズのフィールドへのオフセット。 フィールドのサイズは dwRedirectionIDSize によって指定されます。
dwRedirectionIDNameSize
リダイレクトパーティ ID 名のサイズ (バイト単位)。
dwRedirectionIDNameOffset
構造体の先頭から、リダイレクトパーティ ID 名情報を含む可変サイズのフィールドへのオフセット。 フィールドのサイズは dwRedirectionIDNameSize によって指定されます。
dwRedirectingIDFlags
リダイレクト側識別子情報の有効性と内容を決定します。 リダイレクト 側は、セッションをリダイレクトするアドレスを識別します。 このメンバーは、 LINECALLPARTYID_定数のいずれかを使用します。
dwRedirectingIDSize
リダイレクトパーティ ID 番号のサイズ (バイト単位)。
dwRedirectingIDOffset
構造体の先頭から、リダイレクトパーティ ID 番号情報を含む可変サイズのフィールドへのオフセット。 フィールドのサイズは dwRedirectingIDSize によって指定されます。
dwRedirectingIDNameSize
null ターミネータを含むリダイレクトパーティ ID 名のサイズ (バイト単位)。
dwRedirectingIDNameOffset
構造体の先頭から、リダイレクトパーティ ID 名情報を含む可変サイズのフィールドへのオフセット。 フィールドのサイズは dwRedirectingIDNameSize によって指定されます。
dwAppNameSize
null 終端記号を含むアプリケーション名フィールドのサイズ (バイト単位)。
dwAppNameOffset
構造体の先頭から、最初に呼び出しを開始、受け入れ、または応答したアプリケーションのわかりやすい名前を保持する可変サイズのフィールドへのオフセット。 これは、アプリケーションが lineInitializeEx で指定できる名前です。 アプリケーションでそのような名前が指定されていない場合は、代わりにアプリケーションのモジュール ファイル名が使用されます。 フィールドのサイズは dwAppNameSize で指定します。
dwDisplayableAddressSize
null 終端記号を含む表示可能なアドレス文字列のサイズ (バイト単位)。
dwDisplayableAddressOffset
表示可能な文字列は、ログ記録のために使用されます。 この情報は、呼び出しを開始する関数の LINECALLPARAMS から取得されます。 lineTranslateAddress 関数は、LINETRANSLATEOUTPUT 構造体の dwDisplayableAddressSize および dwDisplayableAddressOffset メンバーのこのフィールドに配置する適切な情報を返します。
dwCalledPartySize
呼び出し先の説明フィールドのサイズ (バイト単位)。
dwCalledPartyOffset
構造体の先頭から、呼び出し先のわかりやすい説明を指定する可変サイズのフィールドへのオフセット。 この情報は lineMakeCall で指定でき、必要に応じて、新しい呼び出しが確立されるたびに lpCallParams パラメーターで指定できます。 これは、呼び出しログの目的で役立ちます。 フィールドのサイズは dwCalledPartySize によって指定されます。
dwCommentSize
コメント フィールドのサイズ (バイト単位)。
dwCommentOffset
lineMakeCall を使用して呼び出しを開始したアプリケーションによって提供される呼び出しに関するコメントを保持する、構造体の先頭から可変サイズのフィールドへのオフセット。 この情報は、必要に応じて、新しい呼び出しが確立されるたびに lpCallParams パラメーターで指定できます。 フィールドのサイズは dwCommentSize で指定します。
dwDisplaySize
生の表示情報のサイズ (バイト単位)。
dwDisplayOffset
構造の先頭から、生の表示情報を保持する可変サイズのフィールドへのオフセット。 テレフォニー環境によっては、サービス プロバイダーは、このテレフォニー構成に最も適した書式設定とプレゼンテーションのために、このメンバー ペアから機能情報を抽出する場合があります。 フィールドのサイズは dwDisplaySize で指定します。
dwUserUserInfoSize
ユーザーとユーザーの情報のサイズ (バイト単位)。 ユーザーとユーザーの情報が文字列へのポインターである場合、サイズには null 終端記号を含める必要があります。
dwUserUserInfoOffset
構造体の先頭から、ユーザーとユーザーの情報を保持する可変サイズのフィールドへのオフセット。 ユーザーユーザー情報のプロトコル判別フィールド (使用されている場合) は、 dwUserUserInfoOffset が指すデータの最初のバイトとして表示され、 dwUserUserInfoSize で が考慮されます。
dwHighLevelCompSize
高レベルの互換性情報のサイズ (バイト単位)。
dwHighLevelCompOffset
構造の先頭から、高レベルの互換性情報を保持する可変サイズのフィールドへのオフセット。 この情報の形式は、他の標準 (ISDN Q.931) で指定されています。 フィールドのサイズは dwHighLevelCompSize によって指定されます。
dwLowLevelCompSize
下位レベルの互換性情報のサイズ (バイト単位)。
dwLowLevelCompOffset
構造の先頭から、低レベルの互換性情報を保持する可変サイズのフィールドへのオフセット。 この情報の形式は、他の標準 (ISDN Q.931) で指定されています。 フィールドのサイズは dwLowLevelCompSize によって指定されます。
dwChargingInfoSize
充電情報のサイズ (バイト単位)。
dwChargingInfoOffset
構造体の先頭から充電情報を保持する可変サイズのフィールドへのオフセット。 この情報の形式は、他の標準 (ISDN Q.931) で指定されています。 フィールドのサイズは dwChargingInfoSize によって指定されます。
dwTerminalModesSize
現在のターミナル モード配列のサイズ (バイト単位)。
dwTerminalModesOffset
構造体の先頭から 、DWORD サイズのエントリを含む配列を含む可変サイズのデバイス フィールドへのオフセット。 配列エントリは、0 から dwNumTerminals より 1 未満の範囲のターミナル識別子によってインデックスが作成されます。 配列内の各エントリは、LINETERMMODE_定数のいずれかで指定されているように、この呼び出しのメディア ストリームの lineSetTerminal 関数を使用して、対応するターミナル セットの現在のターミナル モードを指定 します。 配列のサイズは dwTerminalModesSize によって指定されます。
dwDevSpecificSize
デバイス固有のフィールドのサイズ (バイト単位)。
dwDevSpecificOffset
構造体の先頭から、デバイス固有の情報を保持する可変サイズのフィールドへのオフセット。 フィールドのサイズは dwDevSpecificSize によって指定されます。
dwCallTreatment
呼び出しに現在適用されている呼び出し処理、または呼び出しが次に該当する状態になったときに適用される呼び出し処理。 呼び出し処理がサポートされていない場合は、ゼロにすることができます。
dwCallDataSize
アプリケーション設定可能な呼び出しデータのサイズ (バイト単位)。
dwCallDataOffset
構造体の先頭からアプリケーション設定可能な呼び出しデータへのオフセット。 フィールドのサイズは dwCallDataSize によって指定されます。
dwSendingFlowspecSize
サービス情報の品質のサイズ (バイト単位)。
dwSendingFlowspecOffset
構造体の先頭から FLOWSPEC 構造体へのオフセット。その後に WinSock プロバイダー固有のデータが続きます。これは、QOS 構造体の SendingFlowspec に格納されているものと同等です。 通話の送信方向で現在有効になっているサービスの品質を指定します。 FLOWSPEC 構造体の後のプロバイダー固有の部分には、他のメモリ ブロックへのポインターを含めてはなりません。TAPI は、プライベート ポインターが指すデータをマーシャリングし、アプリケーションへのプロセス間通信を通じてそれを伝達する方法を知らないためです。 フィールドのサイズは dwSendingFlowspecSize によって指定されます。
dwReceivingFlowspecSize
サービス情報の品質のサイズ (バイト単位)。
dwReceivingFlowspecOffset
構造体の先頭から FLOWSPEC 構造体へのオフセット。その後に WinSock プロバイダー固有のデータが続きます。これは、QOS 構造体の ReceivingFlowspec に格納されているものと同等です。 通話の受信方向に現在有効なサービス品質を指定します。 FLOWSPEC 構造体の後のプロバイダー固有の部分には、他のメモリ ブロックへのポインターを含めてはなりません。TAPI は、プライベート ポインターが指すデータをマーシャリングし、アプリケーションへのプロセス間通信を通じてそれを伝達する方法を知らないためです。 フィールドのサイズは dwReceivingFlowspecSize によって指定されます。
dwCallerIDAddressType
呼び出し元のアドレスの種類。 構造体のこのメンバーは、ネゴシエートされた TAPI バージョンが 3.0 以上の場合にのみ使用できます。
dwCalledIDAddressType
呼び出し先のアドレスの種類。 構造体のこのメンバーは、ネゴシエートされた TAPI バージョンが 3.0 以上の場合にのみ使用できます。
dwConnectedIDAddressType
通話が実際に接続された宛先のアドレスの種類。 構造体のこのメンバーは、ネゴシエートされた TAPI バージョンが 3.0 以上の場合にのみ使用できます。
dwRedirectionIDAddressType
新しい呼び出し先のアドレスの種類。 構造体のこのメンバーは、ネゴシエートされた TAPI バージョンが 3.0 以上の場合にのみ使用できます。
dwRedirectingIDAddressType
呼び出しをリダイレクトした場所のアドレスの種類。 構造体のこのメンバーは、ネゴシエートされた TAPI バージョンが 3.0 以上の場合にのみ使用できます。
注釈
デバイス固有の拡張機能では、このデータ構造の DevSpecific (dwDevSpecificSize と dwDevSpecificOffset) の可変サイズ領域を使用する必要があります。
LINECALLINFO データ構造には、呼び出しに関する比較的固定された情報が含まれています。 この構造体は 、lineGetCallInfo で返されます。 このデータ構造の情報項目が変更されると、LINE_CALLINFO メッセージがアプリケーションに送信されます。 このメッセージのパラメーターは、変更された情報項目またはフィールドです。
dwReceivingFlowspecOffset を介したメンバー dwCallTreatment は、API バージョンが 2.0 以降のライン デバイスを開くアプリケーションでのみ使用できます。
要件
| 要件 | 値 |
|---|---|
| Header | tapi.h |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示