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	Tapi.h

こちらもご覧ください

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown