LINEADDRESSCAPS 構造体 (tapi.h)
LINEADDRESSCAPS 構造体は、指定されたアドレスの機能を記述します。 lineGetAddressCaps 関数と TSPI_lineGetAddressCaps 関数は、LINEADDRESSCAPS 構造体を返します。
構文
typedef struct lineaddresscaps_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwLineDeviceID;
DWORD dwAddressSize;
DWORD dwAddressOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwAddressSharing;
DWORD dwAddressStates;
DWORD dwCallInfoStates;
DWORD dwCallerIDFlags;
DWORD dwCalledIDFlags;
DWORD dwConnectedIDFlags;
DWORD dwRedirectionIDFlags;
DWORD dwRedirectingIDFlags;
DWORD dwCallStates;
DWORD dwDialToneModes;
DWORD dwBusyModes;
DWORD dwSpecialInfo;
DWORD dwDisconnectModes;
DWORD dwMaxNumActiveCalls;
DWORD dwMaxNumOnHoldCalls;
DWORD dwMaxNumOnHoldPendingCalls;
DWORD dwMaxNumConference;
DWORD dwMaxNumTransConf;
DWORD dwAddrCapFlags;
DWORD dwCallFeatures;
DWORD dwRemoveFromConfCaps;
DWORD dwRemoveFromConfState;
DWORD dwTransferModes;
DWORD dwParkModes;
DWORD dwForwardModes;
DWORD dwMaxForwardEntries;
DWORD dwMaxSpecificEntries;
DWORD dwMinFwdNumRings;
DWORD dwMaxFwdNumRings;
DWORD dwMaxCallCompletions;
DWORD dwCallCompletionConds;
DWORD dwCallCompletionModes;
DWORD dwNumCompletionMessages;
DWORD dwCompletionMsgTextEntrySize;
DWORD dwCompletionMsgTextSize;
DWORD dwCompletionMsgTextOffset;
DWORD dwAddressFeatures;
DWORD dwPredictiveAutoTransferStates;
DWORD dwNumCallTreatments;
DWORD dwCallTreatmentListSize;
DWORD dwCallTreatmentListOffset;
DWORD dwDeviceClassesSize;
DWORD dwDeviceClassesOffset;
DWORD dwMaxCallDataSize;
DWORD dwCallFeatures2;
DWORD dwMaxNoAnswerTimeout;
DWORD dwConnectedModes;
DWORD dwOfferingModes;
DWORD dwAvailableMediaModes;
} LINEADDRESSCAPS, *LPLINEADDRESSCAPS;
メンバー
dwTotalSize
このデータ構造に割り当てられた合計サイズ (バイト単位)。
dwNeededSize
返されるすべての情報を保持するために必要なこのデータ構造のサイズ (バイト単位)。
dwUsedSize
有用な情報を含むこのデータ構造の部分のサイズ (バイト単位)。
dwLineDeviceID
このアドレスが関連付けられている回線デバイスのデバイス識別子。
dwAddressSize
アドレス フィールドのサイズ (バイト単位)。
dwAddressOffset
構造体の先頭から可変サイズのアドレス フィールドへのオフセット。 フィールドのサイズは dwAddressSize で指定します。
dwDevSpecificSize
デバイス固有のフィールドのサイズ (バイト単位)。
dwDevSpecificOffset
構造体の先頭から可変サイズのデバイス固有フィールドへのオフセット。 フィールドのサイズは dwDevSpecificSize によって指定されます。
dwAddressSharing
アドレスの共有モード。 このメンバーには、 LINEADDRESSSHARING_定数のいずれかを指定できます。
dwAddressStates
LINE_ADDRESSSTATE メッセージでアプリケーションに通知を受け取る可能性があるアドレス状態の変更。 このメンバーは、1 つ以上の LINEADDRESSSTATE_定数を使用します。
dwCallInfoStates
このアドレスのすべての呼び出しに対して意味のある呼び出し情報要素。 アプリケーションは、LINE_CALLINFO メッセージ内のこれらの状態の一部の変更に関する通知 を 受け取る場合があります。 このメンバーは、1 つ以上の LINECALLINFOSTATE_定数を使用します。
dwCallerIDFlags
このアドレスの呼び出しに指定できるパーティ識別子情報の種類。 呼び出し元は、セッションの発信元です。 1 つ以上の LINECALLPARTYID_定数。
dwCalledIDFlags
このアドレスの呼び出しに指定できるパーティ識別子情報の種類。 ここで、「呼び出された」とは、元の宛先を指します。 1 つ以上の LINECALLPARTYID_定数。
dwConnectedIDFlags
このアドレスの呼び出しに指定できるパーティ識別子情報の種類。 1 つ以上の LINECALLPARTYID_定数。
dwRedirectionIDFlags
このアドレスの呼び出しに指定できるパーティ識別子情報の種類。 ここで、"リダイレクト" は新しい宛先です。 1 つ以上の LINECALLPARTYID_定数。
dwRedirectingIDFlags
このアドレスの呼び出しに指定できるパーティ識別子情報の種類。 ここで、"リダイレクト" はリダイレクトを呼び出したアドレスです。 1 つ以上の LINECALLPARTYID_定数。
dwCallStates
このアドレスの呼び出しに対して報告できる通話状態。 このメンバーは、1 つ以上の LINECALLSTATE_定数を使用します。
dwDialToneModes
このアドレスに対して行われた呼び出しに対して報告できるダイヤル トーン モード。 このメンバーは、 ダイヤルトーン 呼び出し状態を報告できる場合にのみ意味があります。 このメンバーは、1 つ以上の LINEDIALTONEMODE_定数を使用します。
dwBusyModes
このアドレスで行われた呼び出しに対して報告できるビジー モード。 このメンバーは、 ビジー 状態を報告できる場合にのみ意味があります。 このメンバーは、1 つ以上の LINEBUSYMODE_定数を使用します。
dwSpecialInfo
このアドレスで行われた呼び出しに対して報告できる特殊な情報の種類。 このメンバーは、 specialInfo 呼び出し状態を報告できる場合にのみ意味があります。 このメンバーは、1 つ以上の LINESPECIALINFO_定数を使用します。
dwDisconnectModes
このアドレスで行われた呼び出しに対して報告できる切断モード。 このメンバーは、 切断された 呼び出し状態を報告できる場合にのみ意味があります。 このメンバーは、1 つ以上の LINEDISCONNECTMODE_定数を使用します。
dwMaxNumActiveCalls
アドレスで処理できるアクティブな呼び出しの外観の最大数。 この番号には、保留中の通話や保留中の転送または会議の通話は含まれません。
dwMaxNumOnHoldCalls
保留にできるアドレスでの呼び出しの出現の最大数。
dwMaxNumOnHoldPendingCalls
保留中の転送または会議を保留にできる、アドレスでの通話の出現の最大数。
dwMaxNumConference
このアドレスで 1 回の電話会議に参加できるパーティの最大数。
dwMaxNumTransConf
lineSetupTransfer を使用して汎用の相談呼び出しとして開始される電話会議に追加できるパーティの数 ("自己" を含む)。
dwAddrCapFlags
さまざまなアドレス機能を記述するパックされたビット フラグ。 このメンバーは、1 つ以上の LINEADDRCAPFLAGS_定数を使用します。
dwCallFeatures
LINECALLFEATURE_定数を使用して、このアドレスのすべての呼び出しで使用できる機能または機能を切り替える。 このメンバーは、アドレスで使用できる可能性がある通話関連の機能を表します (動的可用性ではなく静的可用性)。 サポートされている機能を呼び出すには、呼び出しが適切な状態であり、基になる回線デバイスを互換モードで開く必要があります。 ビット位置の 0 は、対応する機能が使用できないことを示します。 1 つは、アプリケーションが呼び出しに対する適切な特権を持ち、呼び出しが操作が意味を持つ適切な状態にある場合に、対応する機能を使用できる可能性があることを示します。 このメンバーを使用すると、アプリケーションは、アドレスでサポートできる呼び出し機能 (およびサポートできない呼び出し機能) を検出できます。
dwRemoveFromConfCaps
電話会議から通話を削除するためのアドレスの機能。 このメンバーは、 LINEREMOVEFROMCONF_定数のいずれかを使用します。
dwRemoveFromConfState
LINECALLSTATE_定数を使用して、電話会議から通話が削除された後の通話の状態を指定します。
dwTransferModes
転送要求を解決するためのアドレスの機能。 このメンバーは、 LINETRANSFERMODE_定数のいずれかを使用します。
dwParkModes
このアドレスで使用できるさまざまなコール パーク モード。 このメンバーは、 LINEPARKMODE_定数のいずれかを使用します。
dwForwardModes
このアドレスで使用できるさまざまな転送モード。 このメンバーは、 LINEFORWARDMODE_定数を使用します。
dwMaxForwardEntries
lpForwardList パラメーターで lineForward に渡すことができるエントリの最大数。
dwMaxSpecificEntries
lineForward に渡される lpForwardList パラメーターのエントリの最大数。特定の呼び出し元 ID (選択的呼び出し転送) に基づく転送命令を含めることができます。 選択的呼び出し転送がサポートされていない場合、このメンバーは 0 です。
dwMinFwdNumRings
呼び出しが正式に "応答なし" と見なされるタイミングを決定するために設定できるリングの最小数。
dwMaxFwdNumRings
呼び出しが正式に "応答なし" と見なされるタイミングを決定するために設定できるリングの最大数。この数のリングを設定できない場合、 dwMinFwdNumRings と dwMaxNumRings は等しくなります。
dwMaxCallCompletions
この回線デバイスで未処理にできる同時呼び出し完了要求の最大数。 0 は、呼び出しの完了が使用できないことを意味します。
dwCallCompletionConds
呼び出しの完了を要求できるさまざまな呼び出し条件。 このメンバーは、1 つ以上のLINECALLCOMPLCOND_定数を使用します。
dwCallCompletionModes
呼び出しを完了できる方法。 このメンバーは、LINECALLCOMPLMODE_定数のいずれかを使用します。
dwNumCompletionMessages
LINECALLCOMPLMODE_MESSAGE オプションを使用するときに選択できる通話完了メッセージの数。 個々のメッセージは、0 から dwNumCompletionMessages より 1 未満の範囲の値によって識別されます。
dwCompletionMsgTextEntrySize
dwCompletionMsgTextSize および dwCompletionMsgTextOffset で指定された各呼び出し完了テキスト記述のサイズ (バイト単位)。
dwCompletionMsgTextSize
呼び出し完了テキストのサイズ (バイト単位)。
dwCompletionMsgTextOffset
このデータ構造の先頭から、各呼び出し完了メッセージに関する説明テキストを含む可変サイズのフィールドへのオフセット。 各メッセージは dwCompletionMsgTextEntrySize バイト長です。 これらのテキスト記述の文字列形式は、行のデバイス機能で dwStringFormat によって示されます。 フィールドのサイズは dwCompletionMsgTextSize で指定します。
dwAddressFeatures
LINEADDRFEATURE_定数を使用して、このアドレスで使用できる機能。 サポートされている機能を呼び出すには、アドレスが適切な状態であり、基になる回線デバイスが互換モードで開かれている必要があります。 ビット位置の 0 は、対応する機能が使用できないことを示します。 1 つは、アドレスが操作が意味を持つ適切な状態にある場合に、対応する機能を使用できる可能性があることを示します。 このメンバーを使用すると、アプリケーションは、アドレスでサポートできる (およびサポートできない) アドレス機能を検出できます。
dwPredictiveAutoTransferStates
通話の状態または予測ダイヤラによって行われた呼び出しを、呼び出しを別のアドレスに自動的に転送するように設定できる状態。1 つ以上の LINECALLSTATE_定数。 値 0 は、呼び出し状態に基づく自動転送が使用できないことを示します。
dwNumCallTreatments
dwCallTreatmentListSize および dwCallTreatmentListOffset で区切られた LINECALLTREATMENTENTRY 構造体の配列内のエントリ数。
dwCallTreatmentListSize
呼び出し処理配列のサイズ (バイト単位)。
dwCallTreatmentListOffset
構造体の先頭から LINECALLTREATMENTENTRY 構造体の配列へのオフセットは、アドレスでサポートされている呼び出し処理を指定します ( lineSetCallTreatment を使用して選択できます)。 値は dwNumCallTreatments 回 SIZEOF(LINECALLTREATMENTENTRY) です。 フィールドのサイズは dwCallTreatmentListSize によって指定されます。
dwDeviceClassesSize
サポートされているデバイス クラスの一覧のサイズ (バイト単位)。
dwDeviceClassesOffset
構造体の先頭から、 lineGetID で使用するためにこのアドレスでサポートされているデバイス クラス識別子で構成される文字列へのオフセット。 要素は null 文字で区切られ、最後のクラス識別子の後に 2 つの null 文字が続きます。 フィールドのサイズは dwDeviceClassesSize によって指定されます。
dwMaxCallDataSize
lineSetCallData を使用して LINECALLINFO でアプリケーションが設定できる最大バイト数。
dwCallFeatures2
LINECALLFEATURE2_定数を使用して、このアドレスのすべての呼び出しで使用できる追加の切り替え機能。 dwCallFeatures メンバーの拡張機能です。
dwMaxNoAnswerTimeout
呼び出し時に LINECALLPARAMS の dwNoAnswerTimeout メンバーで設定できる最大値 (秒単位)。 値 0 は、応答されていない呼び出しの自動破棄がサービス プロバイダーでサポートされていないこと、またはタイムアウト値がアプリケーションによって調整されないことを示します。
dwConnectedModes
LINECONNECTEDMODE_値は、LINECALLSTATUS の dwCallStateMode メンバーと、このアドレスの呼び出しのメッセージLINE_CALLSTATEに表示できます。
dwOfferingModes
LINECALLSTATUS の dwCallStateMode メンバーと、このアドレスの呼び出しのLINE_CALLSTATEメッセージに表示できる値をLINEOFFERINGMODE_します。
dwAvailableMediaModes
dwAddressFeatures メンバーが新しい呼び出しが可能であることを示している場合に、このアドレスで作成された新しい呼び出しで呼び出すことができるメディアの種類 (モード)。 このメンバーが 0 の場合、サービス・プロバイダーが使用可能なメディア・タイプを認識していないか、または示すことができないことを示します。その場合、LINEDEVCAPS の dwMediaModes メンバーに示されているメディア・タイプの一部またはすべてが使用可能である可能性があります。
解説
デバイス固有の拡張機能では、このデータ構造の DevSpecific (dwDevSpecificSize と dwDevSpecificOffset) の可変サイズ領域を使用する必要があります。
古いアプリケーションは、 LINEADDRESSCAPS 構造体でこのメンバーなしでコンパイルされ、新しいサイズよりも小さい SIZEOF(LINEADDRESSCAPS) を使用します。 アプリケーションは、lineGetAddressCaps 関数を使用して dwAPIVersion パラメーターを渡します。これは、このような状況を処理する TAPI によるガイダンスに使用できます。 指定された dwAPIVersion メンバーで定義されている構造体の固定部分のサイズより小さい dwTotalSize メンバーをアプリケーションが渡すと、LINEERR_STRUCTURETOOSMALLが返されます。 アプリケーションによって十分なメモリが割り当てられている場合、 TSPI_lineGetAddressCapsを呼び出す前に、TAPI は dwNeededSize メンバーと dwUsedSize メンバーを、指定された API バージョンに存在する構造体の固定サイズに設定します。
(新しい API バージョンをサポートする) 新しいサービス プロバイダーは、渡された API バージョンを調べる必要があります。 API バージョンがプロバイダーでサポートされている最も高いバージョンより小さい場合、サービス プロバイダーは、古い API バージョンでサポートされていないフィールドを入力しないでください。これは、古い構造体の変数部分に含まれるのでです。
新しいアプリケーションは、ネゴシエートされた API バージョンを認識し、ネゴシエートされた API バージョンの構造体の固定部分の元の末尾を超える固定部分のフィールドの内容を調べないようにする必要があります。
dwAvailableMediaModes を介したメンバー dwPredictiveAutoTransferStates は、lineGetAddressCaps を呼び出すときに 2.0 以降の API バージョンを要求するアプリケーションでのみ使用できます。
必要条件
| Header | tapi.h |
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示