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 |
|