LINE_LINEDEVSTATE メッセージ

  • [アーティクル]

TAPI LINE_LINEDEVSTATE メッセージは、回線デバイスの状態が変更されたときに送信されます。 アプリケーションは lineGetLineDevStatus を呼び出して、行の新しい状態を判断できます。

パラメーター

hDevice

回線デバイスへのハンドル。 dwParam1 がLINEDEVSTATE_REINITされている場合、このパラメーターは NULL です。

dwCallbackInstance

行を開くときに指定されたコールバック インスタンス。 dwParam1 パラメーターがLINEDEVSTATE_REINIT場合、dwCallbackInstance パラメーターは無効であり、0 に設定されます。

dwParam1

変更された行デバイスの状態項目。 パラメーターには、1 つ以上の LINEDEVSTATE_定数を指定できます。

dwParam2

このパラメーターの解釈は 、dwParam1 の値によって異なります。 dwParam1 がLINEDEVSTATE_RINGING場合、dwParam2 には、スイッチが回線にリングを指示するリング モードが含まれます。 有効なリング モードは、1 から dwNumRingModes までの範囲の数値です。 dwNumRingModes はライン デバイス機能です。

dwParam1 がLINEDEVSTATE_REINITされ、新しい API メッセージを REINIT メッセージに変換した結果として TAPI によってメッセージが発行された場合、dwParam2 には元のメッセージの dwMsg パラメーター (LINE_CREATEやLINE_LINEDEVSTATEなど) が含まれます。 dwParam2 が 0 の場合、REINIT メッセージが "実際の" REINIT メッセージであることを示します。このメッセージは、アプリケーションで lineShutdown を最も早く呼び出す必要があることを示します。

dwParam3

このパラメーターの解釈は 、dwParam1 の値によって異なります。 dwParam1 がLINEDEVSTATE_RINGING場合、dwParam3 にはこのリング イベントのリング数が含まれます。 リング数は 0 から始まります。

dwParam1 がLINEDEVSTATE_REINITされ、新しい API メッセージを REINIT メッセージに変換した結果として TAPI によってメッセージが発行された場合、dwParam3 には元のメッセージの dwParam1 パラメーターが含まれます (たとえば、dwParam2 がLINE_LINEDEVSTATEの場合はLINEDEVSTATE_TRANSLATECHANGEまたはその他のLINEDEVSTATE_値、dwParam2 がLINE_CREATE場合は新しいデバイス識別子)。

戻り値

戻り値はありません。

解説

LINE_LINEDEVSTATE メッセージの送信は、lineSetStatusMessages で制御できます。 アプリケーションは、通知を受け取る状態項目の変更を示すことができます。 既定では、無効にできないLINEDEVSTATE_REINITを除き、すべての状態レポートが無効になります。 このメッセージは、行へのハンドルを持つすべてのアプリケーションに送信されます。これには、dwPrivileges パラメーターが LINECALLPRIVILEGE_NONE、LINECALLPRIVILEGE_OWNER、LINECALLPRIVILEGE_MONITOR、または許可された組み合わせに設定された lineOpen と呼ばれるものも含まれます。

要件

要件 値
TAPI バージョン
 TAPI 2.0 以降が必要です
ヘッダー
Tapi.h

関連項目

LINE_CLOSE

LINE_CREATE

LINEDEVCAPS

lineGetDevCaps

lineGetDevConfig

lineGetTranslateCaps

lineInitialize

lineOpen

lineSetStatusMessages

lineShutdown

LINETRANSLATECAPS

lineUncompleteCall