PHONE_REMOVE メッセージ
TAPI PHONE_REMOVE メッセージは、電話デバイスの削除 (システムからの削除) をアプリケーションに通知するために送信されます。 一般に、これは PCMCIA デバイスの抽出などの一時的な削除には使用されませんが、TAPI が再初期化された場合にデバイスがサービス プロバイダーによって報告されなくなる永続的な削除に対してのみ使用されます。
パラメーター
-
hDevice
-
予約済み。 0 に設定します。
-
dwCallbackInstance
-
予約済み。 0 に設定します。
-
dwParam1
-
削除された電話デバイスの識別子。
-
dwParam2
-
予約済み。 0 に設定します。
-
dwParam3
-
予約済み。 0 に設定します。
戻り値
戻り値はありません。
解説
アプリケーション TAPI バージョン 2.0 以降では、 PHONE_REMOVE メッセージが送信されます。 これにより、デバイスがシステムから削除されたことが通知されます。 アプリケーションが電話を開いている場合、 PHONE_REMOVE メッセージの前に各電話ハンドルの PHONE_CLOSE メッセージが表示されます。 このメッセージは、 phoneInitializeEx を呼び出した TAPI バージョン 2.0 以降をサポートするすべてのアプリケーション (その時点で電話デバイスが開かっていないアプリケーションを含む) に送信されます。
以前のアプリケーション (TAPI バージョン 1.4 以前をネゴシエートした) には、PHONESTATE_REMOVEDを指定する PHONE_STATE メッセージが送信され、その後に PHONE_CLOSE メッセージが送信されます。 ただし、 PHONE_REMOVE メッセージとは異なり、これらの古いアプリケーションは、電話機が取り外されたときに電話を開いている場合にのみ、これらのメッセージを受信できます。 電話を開いていなくても、デバイスが削除されたことを示す唯一の兆候は、デバイスにアクセスしようとしたときにPHONEERR_NODEVICEを受け取ることになります。
デバイスが削除されると、デバイス識別子によってデバイスにアクセスしようとすると、PHONEERR_NODEVICE エラーが発生します。 TAPI を再起動できるようにすべての TAPI アプリケーションがシャットダウンされた後、TAPI が再初期化されると、削除されたデバイスはデバイス識別子を占有しなくなります。
Note
実装: サービス プロバイダーからPHONE_REMOVE メッセージを受信した後、このPHONEERR_NODEVICE メッセージを返す TAPI です。その電話デバイス識別子を使用して、そのサービス プロバイダーに対してそれ以上の呼び出しは行われません。
要件
| 要件 | 値 |
|---|---|
| TAPI バージョン |
TAPI 2.0 以降が必要です |
| ヘッダー |
|