LINECALLSTATUS 構造体 (tapi.h)
LINECALLSTATUS 構造体は、呼び出しの現在の状態を表します。 この構造体の情報は、アドレスのデバイス機能、呼び出し元アプリケーションによる呼び出しの所有権、およびクエリ対象の呼び出しの現在の状態によって異なります。 lineGetCallStatus 関数と TSPI_lineGetCallStatus 関数は、LINECALLSTATUS 構造体を返します。
構文
typedef struct linecallstatus_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwCallState;
DWORD dwCallStateMode;
DWORD dwCallPrivilege;
DWORD dwCallFeatures;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwCallFeatures2;
#if ...
SYSTEMTIME tStateEntryTime;
#else
WORD tStateEntryTime[8];
#endif
} LINECALLSTATUS, *LPLINECALLSTATUS;
メンバー
dwTotalSize
このデータ構造に割り当てられた合計サイズ (バイト単位)。
dwNeededSize
返されるすべての情報をバイト単位で保持するために必要な、このデータ構造のサイズ。
dwUsedSize
有用な情報を含むこのデータ構造の部分のサイズ (バイト単位)。
dwCallState
LINECALLSTATE_定数のいずれかを使用した呼び出しの現在の呼び出し状態。
dwCallStateMode
dwCallStateMode メンバーの解釈は、呼び出し状態に依存します。 多くの場合、値は 0 になります。 次の表は、指定 された dwCallState 値の dwCallStateMode 型を 示しています。
| dwCallState | 意味 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
dwCallPrivilege
この呼び出しに対するアプリケーションの特権。 このメンバーは、1 つ以上の LINECALLPRIVILEGE_定数を使用します。
dwCallFeatures
デバイス機能の機能の可用性、現在の呼び出し状態、呼び出し元アプリケーションの呼び出し所有権を指定して、呼び出しで呼び出すことができるテレフォニー API 関数を示すフラグ。 0 は、現在の状態の呼び出しでアプリケーションが対応する機能を呼び出すことができない場合を示します。1 つは、機能を呼び出すことができる場合を示します。 このメンバーは 、LINECALLFEATURE_定数を使用します。
dwDevSpecificSize
デバイス固有フィールドのサイズ (バイト単位)。
dwDevSpecificOffset
構造体の先頭から可変サイズのデバイス固有フィールドへのオフセット。 フィールドのサイズは dwDevSpecificOffset によって指定されます。
dwCallFeatures2
デバイス機能の機能の可用性、現在の呼び出し状態、呼び出し元アプリケーションの呼び出し所有権を指定して、呼び出しで追加の関数を呼び出すことができる場合を示します。 dwCallFeatures メンバーの拡張機能。 このメンバーは 、LINECALLFEATURE2_定数を使用します。
tStateEntryTime
現在の呼び出し状態が入力された協定世界時。
tStateEntryTime[8]
現在の呼び出し状態が入力された協定世界時。
注釈
デバイス固有の拡張機能では、このデータ構造の DevSpecific (dwDevSpecificSize と dwDevSpecificOffset) の可変サイズ領域を使用する必要があります。
アプリケーションは、呼び出 しの 呼び出し状態が変更されるたびに、LINE_CALLSTATE メッセージを送信します。 このメッセージは、呼び出しの新しい呼び出し状態のみを提供します。 呼び出しに関する追加の状態は、 lineGetCallStatus で使用できます。
メンバー dwCallFeatures2 と tStateEntryTime は、API バージョン 2.0 以降で回線デバイスを開くアプリケーションでのみ使用できます。
要件
| 要件 | 値 |
|---|---|
| Header | tapi.h |