次の方法で共有


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

呼び出しが正式に "応答なし" と見なされるタイミングを決定するために設定できるリングの最大数。この数のリングを設定できない場合、 dwMinFwdNumRingsdwMaxNumRings は等しくなります。

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

呼び出し時に LINECALLPARAMSdwNoAnswerTimeout メンバーで設定できる最大値 (秒単位)。 値 0 は、応答されていない呼び出しの自動破棄がサービス プロバイダーでサポートされていないこと、またはタイムアウト値がアプリケーションによって調整されないことを示します。

dwConnectedModes

LINECONNECTEDMODE_値は、LINECALLSTATUSdwCallStateMode メンバーと、このアドレスの呼び出しのメッセージLINE_CALLSTATEに表示できます。

dwOfferingModes

LINECALLSTATUSdwCallStateMode メンバーと、このアドレスの呼び出しのLINE_CALLSTATEメッセージに表示できる値をLINEOFFERINGMODE_します。

dwAvailableMediaModes

dwAddressFeatures メンバーが新しい呼び出しが可能であることを示している場合に、このアドレスで作成された新しい呼び出しで呼び出すことができるメディアの種類 (モード)。 このメンバーが 0 の場合、サービス・プロバイダーが使用可能なメディア・タイプを認識していないか、または示すことができないことを示します。その場合、LINEDEVCAPSdwMediaModes メンバーに示されているメディア・タイプの一部またはすべてが使用可能である可能性があります。

解説

デバイス固有の拡張機能では、このデータ構造の DevSpecific (dwDevSpecificSizedwDevSpecificOffset) の可変サイズ領域を使用する必要があります。

古いアプリケーションは、 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

関連項目

LINEADDRESSSTATUS

LINECALLINFO

LINECALLPARAMS

LINECALLSTATUS

LINECALLTREATMENTENTRY

LINEDEVCAPS

LINEDIALPARAMS

LINE_ADDRESSSTATE

LINE_CALLINFO

LINE_CALLSTATE

LINE_LINEDEVSTATE

TSPI_lineGetAddressCaps

lineCompleteCall

lineForward

lineGenerateDigits

lineGetAddressCaps

lineGetID

lineSetCallData

lineSetCallTreatment