次の方法で共有


LINEDEVSTATUS 構造体 (tapi.h)

LINEDEVSTATUS 構造体は、回線デバイスの現在の状況を記述します。 lineGetLineDevStatus 関数とTSPI_lineGetLineDevStatus関数は、LINEDEVSTATUS 構造体を返します。

構文

typedef struct linedevstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumOpens;
  DWORD dwOpenMediaModes;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwLineFeatures;
  DWORD dwNumCallCompletions;
  DWORD dwRingMode;
  DWORD dwSignalLevel;
  DWORD dwBatteryLevel;
  DWORD dwRoamMode;
  DWORD dwDevStatusFlags;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAvailableMediaModes;
  DWORD dwAppInfoSize;
  DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;

メンバー

dwTotalSize

このデータ構造に割り当てられた合計サイズ (バイト単位)。

dwNeededSize

返されるすべての情報を保持するために必要なこのデータ構造のサイズ (バイト単位)。

dwUsedSize

有用な情報を含むこのデータ構造の部分のサイズ (バイト単位)。

dwNumOpens

回線デバイスでアクティブな数が開きます。

dwOpenMediaModes

ライン デバイスが現在開いているメディアの種類を示すビット配列。

dwNumActiveCalls

呼び出し中の行の呼び出しの数は、 アイドル状態、 保留状態、 保留保留転送、および 保留保留会議以外の状態です。

dwNumOnHoldCalls

オンホールド状態の行の呼び出しの数。

dwNumOnHoldPendCalls

onholdpendingtransfer または onholdpendingconference 状態の行呼び出しの数。

dwLineFeatures

この行で現在使用できる行関連の関数。 このメンバーは、1 つ以上の LINEFEATURE_定数を使用します

dwNumCallCompletions

行の未処理の呼び出し完了要求の数。

dwRingMode

ライン デバイスの現在のリング モード。

dwSignalLevel

回線上の接続の現在の信号レベル。 これは、0x0000FFFF(最も強い信号)に0x00000000(最も弱い信号)の範囲内の値です。

dwBatteryLevel

ライン デバイス ハードウェアの現在のバッテリ レベル。 これは、0x00000000 (バッテリーが空) から 0x0000FFFF (バッテリーがいっぱい) の範囲内の値です。

dwRoamMode

回線デバイスの現在のローミング モード。 このメンバーは 、LINEROAMMODE_定数のいずれかを使用します。

dwDevStatusFlags

デバイスがロックされているかどうかなど、状態情報を示すフラグ。 LINEDEVSTATUSFLAGS_定数の 1 つ以上のメンバーで構成されます。

dwTerminalModesSize

現在のターミナル モードの配列を含む可変サイズのデバイス フィールドのサイズ (バイト単位)。

dwTerminalModesOffset

構造体の先頭から現在のターミナル モードの配列へのオフセット (バイト単位)。 この配列は、0 から dwNumTerminals から 1 を引いた範囲のターミナル ID によってインデックスが作成されます。 配列内の各エントリは、この 行の lineSetTerminal 関数を使用して、対応するターミナル セットの現在のターミナル モードを指定します。 各エントリは、LINETERMMODE_定数の 1 つ以上を指定する DWORD です。 配列のサイズは dwTerminalModesSize によって指定されます。

dwDevSpecificSize

可変サイズのデバイス固有フィールドのサイズ (バイト単位)。 デバイス固有の情報が文字列へのポインターである場合、サイズには null 終端記号を含める必要があります。

dwDevSpecificOffset

構造体の先頭からデバイス固有のフィールドへのオフセット (バイト単位)。 フィールドのサイズは dwDevSpecificSize によって指定されます。

dwAvailableMediaModes

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

dwAppInfoSize

行が開いているアプリケーションを識別する配列のサイズ (バイト単位)。

dwAppInfoOffset

構造体の先頭から LINEAPPINFO 構造体の配列へのオフセット。 dwNumOpens メンバーは、配列内の要素の数を示します。 配列内の各要素は、行が開いているアプリケーションを識別します。 配列のサイズは dwAppInfoSize で指定します。

解説

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

dwAppInfoOffset を介した dwAvailableMediaModes のメンバーは、API バージョンが 2.0 以降のライン デバイスを開くアプリケーションでのみ使用できます。

要件

   
Header tapi.h

関連項目

LINEAPPINFO

LINEDEVCAPS

TSPI_lineGetLineDevStatus

lineGetLineDevStatus

lineSetTerminal