LINEDEVSTATUS 構造体 (tapi.h)

[アーティクル]
08/26/2023

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 の場合、サービス・プロバイダーが使用可能なメディア・タイプを認識していないか、または示すことができないことを示します。その場合、LINEDEVCAPS の dwMediaModes メンバーに示されているメディア・タイプの一部またはすべてが使用可能である可能性があります。

dwAppInfoSize

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

dwAppInfoOffset

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

解説

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

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

要件


Header	tapi.h

LINEDEVSTATUS 構造体 (tapi.h)

構文

メンバー

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース