PHONE_STATE メッセージ
TAPI は、電話デバイスの状態が変わるたびに、 PHONE_STATE メッセージをアプリケーションに送信します。
パラメーター
-
hPhone
-
電話デバイスへのハンドル。
-
dwCallbackInstance
-
電話デバイスを開くときに提供されるアプリケーションのコールバック インスタンス。
-
dwParam1
-
変更された電話の状態。 このパラメーターは、 PHONESTATE_定数のいずれかを使用します。
-
dwParam2
-
状態の変更を詳しく説明する電話の状態に依存する情報。 dwParam1 で複数のフラグが設定されている場合、複数の状態項目が変更されているため、このパラメーターは使用されません。 アプリケーションは phoneGetStatus を 呼び出して、情報の完全なセットを取得する必要があります。
dwParam1 がPHONESTATE_OWNER場合、dwParam2 には新しい所有者数が含まれます。
dwParam1 がPHONESTATE_MONITORSされている場合、dwParam2 には新しい数のモニターが含まれます。
dwParam1 がPHONESTATE_LAMPされている場合、dwParam2 には、変更されたランプのボタン/ランプ識別子が含まれます。
dwParam1 がPHONESTATE_RINGMODE場合、dwParam2 には新しいリング モードが含まれます。
dwParam1 が PHONESTATE_HANDSET、SPEAKER、または HEADSET の場合、dwParam2 にはそのフックスイッチ デバイスの新しいフックスイッチ モードが含まれます。 このパラメーターは、 PHONEHOOKSWITCHMODE_定数のいずれかを使用します。
-
dwParam3
-
未使用。
戻り値
戻り値はありません。
注釈
PHONE_STATE メッセージをアプリケーションに送信するには、phoneSetStatusMessages と phoneGetStatusMessages を使用して制御およびクエリを実行します。 既定では、このメッセージは、無効にできないPHONESTATE_REINITを除くすべての状態変更に対して無効になります。 このメッセージは、電話へのハンドルを持つすべてのアプリケーションに送信されます。これには、dwPrivileges パラメーターが PHONEPRIVILEGE_OWNER または PHONEPRIVILEGE_MONITOR に設定された phoneOpen と呼ばれるアプリケーションも含まれます。
所有者またはモニターの表示を含む PHONE_STATE メッセージは、電話のハンドルが既にあるアプリケーションに送信されます。 これは、別のアプリケーションが phoneOpen、 phoneClose 、 phoneShutdown を使用して電話デバイスの所有権または監視を変更した結果である可能性があります。
要件
| 要件 | 値 |
|---|---|
| TAPI バージョン |
TAPI 2.0 以降が必要です |
| Header |
|