TSPI_lineGetLineDevStatus関数 (tspi.h)
TSPI_lineGetLineDevStatus関数は、指定されたオープンライン デバイスの現在の状態を照会します。 返される情報は、行のすべてのアドレスに対してグローバルです。
構文
LONG TSPIAPI TSPI_lineGetLineDevStatus(
HDRVLINE hdLine,
LPLINEDEVSTATUS lpLineDevStatus
);
パラメーター
hdLine
クエリを実行する行に対するサービス プロバイダーのハンドル。
lpLineDevStatus
LINEDEVSTATUS 型の可変サイズのデータ構造へのポインター。 この構造体には、回線のデバイスの状態が入力されます。
戻り値
関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。
LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_OPERATIONUNAVAIL。
注釈
次の表は、 TAPI によって入力される LINEDEVSTATUS データ構造のメンバーと、サービス プロバイダーによって入力されるメンバーを示しています。 サービス プロバイダーは、TAPI によって入力された値を保持する (上書きしてはならない) 必要があります。
| メンバー名 | Tapi | サービス プロバイダー |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwNumOpens; | X | |
| dwOpenMediaModes; | X | |
| dwNumActiveCalls; | X | |
| dwNumOnHoldCalls; | X | |
| dwNumOnHoldPendCalls; | X | |
| dwLineFeatures; | X | |
| dwNumCallCompletions; | X | |
| dwRingMode; | X | |
| dwSignalLevel; | X | |
| dwBatteryLevel; | X | |
| dwRoamMode; | X | |
| dwDevStatusFlags; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |