LINECALLPARAMS 構造体 (tapi.h)
LINECALLPARAMS 構造体は、lineMakeCall 関数と TSPI_lineMakeCall 関数を使用して呼び出しを行うときに指定されるパラメーターを記述します。 LINECALLPARAMS 構造体は、lineOpen 関数などの他の操作のパラメーターとしても使用されます。
構文ブロックの右側にあるコメントは、この構造体が lineMakeCall に指定されていない場合に使用される既定値を示します。
構文
typedef struct linecallparams_tag {
DWORD dwTotalSize;
DWORD dwBearerMode;
DWORD dwMinRate;
DWORD dwMaxRate;
DWORD dwMediaMode;
DWORD dwCallParamFlags;
DWORD dwAddressMode;
DWORD dwAddressID;
LINEDIALPARAMS DialParams;
DWORD dwOrigAddressSize;
DWORD dwOrigAddressOffset;
DWORD dwDisplayableAddressSize;
DWORD dwDisplayableAddressOffset;
DWORD dwCalledPartySize;
DWORD dwCalledPartyOffset;
DWORD dwCommentSize;
DWORD dwCommentOffset;
DWORD dwUserUserInfoSize;
DWORD dwUserUserInfoOffset;
DWORD dwHighLevelCompSize;
DWORD dwHighLevelCompOffset;
DWORD dwLowLevelCompSize;
DWORD dwLowLevelCompOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwPredictiveAutoTransferStates;
DWORD dwTargetAddressSize;
DWORD dwTargetAddressOffset;
DWORD dwSendingFlowspecSize;
DWORD dwSendingFlowspecOffset;
DWORD dwReceivingFlowspecSize;
DWORD dwReceivingFlowspecOffset;
DWORD dwDeviceClassSize;
DWORD dwDeviceClassOffset;
DWORD dwDeviceConfigSize;
DWORD dwDeviceConfigOffset;
DWORD dwCallDataSize;
DWORD dwCallDataOffset;
DWORD dwNoAnswerTimeout;
DWORD dwCallingPartyIDSize;
DWORD dwCallingPartyIDOffset;
DWORD dwAddressType;
} LINECALLPARAMS, *LPLINECALLPARAMS;
メンバー
dwTotalSize
このデータ構造に割り当てられた合計サイズ (バイト単位)。 このサイズは、このデータ構造のすべての固定サイズと可変サイズの部分を保持するのに十分な大きさにする必要があります。
dwBearerMode
呼び出しのベアラー モード。 このメンバーは、 LINEBEARERMODE_定数のいずれかを使用します。
dwBearerMode が 0 の場合、既定値はLINEBEARERMODE_VOICE。
dwMinRate
呼び出しのデータ ストリームに対して要求された最小データ レート (bps (1 秒あたりのビット数))。
dwMaxRate
呼び出しのデータ ストリームに対して要求された最大データ レート (bps (ビット/秒)。 サービス プロバイダーは、呼び出しを行うときに、要求された範囲内で使用可能な最高レート (dwMinRate から dwMaxRate) を提供しようとします。 特定のデータ レートが必要な場合は、 dwMinRate と dwMaxRate の 両方をその値に設定する必要があります。 アプリケーションが 1 つのレートで最適に動作し、低いレートに低下する可能性がある場合、アプリケーションでは、それぞれ最大レートと最小レートとしてこれらを指定する必要があります。 dwMaxRate が 0 の場合、既定値は LINEDEVCAPS 構造体の dwMaxRate メンバーによって指定されます。 これは、デバイスでサポートされている最大レートです。
dwMediaMode
呼び出しのメディアの種類が必要です。 このメンバーは、 LINEMEDIAMODE_定数のいずれかを使用します。
dwMediaMode が 0 の場合、既定値はLINEMEDIAMODE_INTERACTIVEVOICE。
dwCallParamFlags
ブール型の呼び出しセットアップ パラメーターのコレクション。 このメンバーは、1 つ以上の LINECALLPARAMFLAGS_定数を使用します。
dwAddressMode
送信元アドレスを指定するモード。 このメンバーは、 LINEADDRESSMODE_定数のいずれかを使用します。
dwAddressID
dwAddressMode が LINEADDRESSMODE_ADDRESSID に設定されている場合の発信元アドレスのアドレス識別子。 アドレス識別子は、アドレスに完全に関連付けられます。識別子は、オペレーティング システムのアップグレード間で一定のままです。
DialParams
この呼び出しで使用される、 種類が LINEDIALPARAMS のダイヤル パラメーター。 このフィールドに値 0 を指定すると、LINEDEVCAPS 構造体の DefaultDialParams メンバーに示されているように、フィールドの既定値が使用されます。 LINEDEVCAPS 構造体の MinDialParams および MaxDialParams の対応するフィールドで指定された範囲外のフィールドに 0 以外の値を指定した場合は、有効な範囲内の最も近い値が代わりに使用されます。
dwOrigAddressSize
発信元アドレス フィールドのサイズ (バイト単位)。
dwOrigAddressOffset
構造体の先頭から、発信元アドレスを保持する可変サイズのフィールドへのオフセット。 このアドレスの形式は dwAddressMode メンバーに依存します。 フィールドのサイズは dwOrigAddressSize によって指定されます。
dwDisplayableAddressSize
null 終端記号を含む表示可能な文字列のサイズ (バイト単位)。
dwDisplayableAddressOffset
ログ記録のために使用される表示可能な文字列。 これらのメンバーの内容は、呼び出しの LINECALLINFO メッセージの dwDisplayableAddressOffset メンバーと dwDisplayableAddressSize メンバーに記録されます。 lineTranslateAddress 関数は、LINETRANSLATEOUTPUT 構造体の dwDisplayableAddressSize および dwDisplayableAddressOffset メンバーのこのフィールドに配置する適切な情報を返します。 フィールドのサイズは dwDisplayableAddressSize によって指定されます。
dwCalledPartySize
呼び出し先情報のサイズ (バイト単位)。
dwCalledPartyOffset
構造体の先頭から、呼び出し先情報を保持する可変サイズのフィールドへのオフセット。 この情報は、呼び出しを行い、ログ記録のために呼び出しの情報構造で使用できるアプリケーションによって指定できます。 このフィールドの形式は、LINEDEVCAPS で指定されている dwStringFormat の形式です。 フィールドのサイズは dwCalledPartySize によって指定されます。
dwCommentSize
呼び出しコメント フィールドのサイズ (バイト単位)。
dwCommentOffset
構造体の先頭から、呼び出しに関するコメントを保持する可変サイズのフィールドへのオフセット。 この情報は、呼び出しを行い、ログ記録のために呼び出しの情報構造で使用できるアプリケーションによって指定できます。 このフィールドの形式は、LINEDEVCAPS で指定されている dwStringFormat の形式です。 フィールドのサイズは dwCommentSize で指定します。
dwUserUserInfoSize
null 終端記号を含むユーザーユーザー情報のサイズ (バイト単位)。
dwUserUserInfoOffset
構造体の先頭から、ユーザーとユーザーの情報を保持する可変サイズのフィールドへのオフセット。 必要に応じて、ユーザーユーザー情報のプロトコル判別フィールドは、 dwUserUserInfoOffset が指すデータの最初のバイトとして表示され、 dwUserUserInfoSize では を考慮する必要があります。
dwHighLevelCompSize
高レベルの互換性情報のサイズ (バイト単位)。
dwHighLevelCompOffset
構造の先頭から、高レベルの互換性情報を保持する可変サイズのフィールドへのオフセット。 フィールドのサイズは dwHighLevelCompSize によって指定されます。
dwLowLevelCompSize
下位レベルの互換性情報のサイズ (バイト単位)。
dwLowLevelCompOffset
構造の先頭から、低レベルの互換性情報を保持する可変サイズのフィールドへのオフセット。 フィールドのサイズは dwLowLevelCompSize によって指定されます。
dwDevSpecificSize
デバイス固有の情報のサイズ (バイト単位)。
dwDevSpecificOffset
構造体の先頭から、デバイス固有の情報を保持する可変サイズのフィールドへのオフセット。 フィールドのサイズは dwDevSpecificSize によって指定されます。
dwPredictiveAutoTransferStates
定数LINECALLSTATE_、指定したターゲット アドレスに呼び出しがブラインド転送されるエントリです。 自動転送が必要ない場合は、0 に設定します。
dwTargetAddressSize
null 終端記号を含むターゲットのダイヤル可能なアドレス文字列のサイズ (バイト単位)。
dwTargetAddressOffset
構造体の先頭から、ターゲットのダイヤル可能アドレス ( dwAddressID ではない) を指定する文字列へのオフセット。特定の自動アクションの場合に使用されます。 予測ダイヤルの場合は、呼び出しを自動的に転送するアドレスを指定します。 文字列のサイズは dwTargetAddressSize によって指定されます。
これは基本的に、自動転送が使用されていない場合に lineBlindTransfer に渡される文字列と同じです。 自動転送が必要ない場合は、0 に設定します。 保留なし会議の場合は、通話に会議する必要があるアドレスを指定します。 ワンステップ転送の場合は、相談呼び出しでダイヤルするアドレスを指定します。
dwSendingFlowspecSize
サービス情報の品質のサイズ (バイト単位)。
dwSendingFlowspecOffset
構造体の先頭から FLOWSPEC 構造体へのオフセット。その後に WinSock プロバイダー固有のデータが続きます。これは、QOS 構造体の SendingFlowspec に格納されているものと同等です。 通話の送信方向に必要なサービス品質を指定します。 FLOWSPEC 構造体の後のプロバイダー固有の部分には、他のメモリ ブロックへのポインターを含めてはなりません。TAPI は、プライベート ポインターが指すデータをマーシャリングし、アプリケーションへのプロセス間通信を通じてそれを伝達する方法を知らないためです。 フィールドのサイズは dwSendingFlowspecSize によって指定されます。
dwReceivingFlowspecSize
サービス情報の品質のサイズ (バイト単位)。
dwReceivingFlowspecOffset
構造体の先頭から FLOWSPEC 構造体へのオフセット。その後に WinSock プロバイダー固有のデータが続きます。これは、QOS 構造体の ReceivingFlowspec に格納されているものと同等です。 通話の受信方向に必要なサービスの品質を指定します。 FLOWSPEC 構造体の後のプロバイダー固有の部分には、他のメモリ ブロックへのポインターを含めてはなりません。TAPI は、プライベート ポインターが指すデータをマーシャリングし、アプリケーションへのプロセス間通信を通じてそれを伝達する方法を知らないためです。 フィールドのサイズは dwReceivingFlowspecSize によって指定されます。
dwDeviceClassSize
null 終端記号を含むデバイス クラス文字列のサイズ (バイト単位)。
dwDeviceClassOffset
構造体の先頭から、DeviceConfig で構成が指定されているデバイスのデバイス クラスを示す null で終わる文字列へのオフセット。 有効なデバイス クラス文字列は、 lineGetID 関数に指定したものと同じです。 文字列のサイズは dwDeviceClassSize によって指定されます。
dwDeviceConfigSize
デバイス構成データのサイズ (バイト単位)。
dwDeviceConfigOffset
構造体の先頭から不透明な構成データ構造へのオフセット。 この値は、lineGetDevConfig によって返される VARSTRING 構造体の dwStringSize メンバーで返されます。 サイズが 0 の場合は、既定のデバイス構成が使用されます。 これにより、呼び出しが開始される前に、アプリケーションでデバイス構成を設定できます。 フィールドのサイズは dwDeviceConfigSize で指定します。
dwCallDataSize
アプリケーション設定可能な呼び出しデータのサイズ (バイト単位)。
dwCallDataOffset
構造体の先頭から、最初に呼び出しにアタッチされるアプリケーション設定可能な呼び出しデータへのオフセット。 フィールドのサイズは dwCallDataSize によって指定されます。
dwNoAnswerTimeout
ダイヤルが完了してから、呼び出しが、LINECALLSTATE_DISCONNECTEDとLINEDISCONNECTMODE_NOANSWERを使用してサービス プロバイダーによって自動的に破棄されるまで、PROCEEDING または RINGBACK 状態で待機できるようにする必要がある秒数。 値 0 は、アプリケーションが自動呼び出しの破棄を望まないことを示します。
dwCallingPartyIDSize
null 終端文字を含む、呼び出し側 ID 文字列のサイズ (null 終端文字を含むバイト単位)。
dwCallingPartyIDOffset
構造体の先頭から、呼び出しを行うパーティの ID を指定する null で終わる文字列へのオフセット。 識別子の内容が許容され、パスが使用可能な場合、サービス プロバイダーは、呼び出し側の ID を示すために、呼び出し側に識別子を渡します。 フィールドのサイズは dwCallingPartyIDSize によって指定されます。
dwAddressType
呼び出しに使用されるアドレスの種類。 構造体のこのメンバーは、ネゴシエートされた TAPI バージョンが 3.0 以上の場合にのみ使用できます。
注釈
デバイス固有の拡張機能では、このデータ構造の DevSpecific (dwDevSpecificSize と dwDevSpecificOffset) の可変サイズ領域を使用する必要があります。
この構造体は、呼び出しを設定するときに lineMakeCall のパラメーターとして使用されます。 そのフィールドを使用すると、アプリケーションはネットワークから要求されるサービスの品質と、さまざまな ISDN 呼び出しセットアップ パラメーターを指定できます。 lineMakeCall に LINECALLPARAMS 構造体が指定されていない場合は、上記の既定値を使用して、既定の POTS 音声グレード呼び出しが要求されます。
要件
| Header | tapi.h |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示