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 以降が必要です |
| ヘッダー |
|