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 メッセージをアプリケーションに送信するには、phoneSetStatusMessagesphoneGetStatusMessages を使用して制御およびクエリを実行できます。 既定では、このメッセージは、無効にできないPHONESTATE_REINITを除くすべての状態変更で無効になります。 このメッセージは、dwPrivileges パラメーターが PHONEPRIVILEGE_OWNER または PHONEPRIVILEGE_MONITOR に設定された phoneOpen と呼ばれるアプリケーションを含め、電話へのハンドルを持つすべてのアプリケーションに送信されます。

所有者やモニターの表示を含む PHONE_STATE メッセージは、電話のハンドルが既にあるアプリケーションに送信されます。 これは、別のアプリケーションが phoneOpenphoneClose 、または phoneShutdown を使用して電話デバイスの所有権または監視を変更した結果である可能性があります。

要件

要件
TAPI バージョン
TAPI 2.0 以降が必要
Header
Tapi.h

関連項目

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown