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 の場合、サービス・プロバイダーが使用可能なメディア・タイプを認識していないか、または示すことができないことを示します。その場合、LINEDEVCAPS の dwMediaModes メンバーに示されているメディア・タイプの一部またはすべてが使用可能である可能性があります。
dwAppInfoSize
行が開いているアプリケーションを識別する配列のサイズ (バイト単位)。
dwAppInfoOffset
構造体の先頭から LINEAPPINFO 構造体の配列へのオフセット。 dwNumOpens メンバーは、配列内の要素の数を示します。 配列内の各要素は、行が開いているアプリケーションを識別します。 配列のサイズは dwAppInfoSize で指定します。
解説
デバイス固有の拡張機能では、このデータ構造の DevSpecific (dwDevSpecificSize と dwDevSpecificOffset) の可変サイズ領域を使用する必要があります。
dwAppInfoOffset を介した dwAvailableMediaModes のメンバーは、API バージョンが 2.0 以降のライン デバイスを開くアプリケーションでのみ使用できます。
要件
| Header | tapi.h |