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 意味
LINECALLSTATE_BUSY

LINEBUSYMODE_定数
LINECALLSTATE_CONNECTED

LINECONNECTEDMODE_定数
LINECALLSTATE_DIALTONE

LINEDIALTONEMODE_定数
LINECALLSTATE_DISCONNECTED

LINEDISCONNECTMODE_定数
LINECALLSTATE_OFFERING

LINEOFFERINGMODE_定数
LINECALLSTATE_SPECIALINFO

LINESPECIALINFO_定数

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

こちらもご覧ください

LINEDIALPARAMS

LINE_CALLSTATE

TSPI_lineGetCallStatus

lineGetCallStatus