プラグイン
1. プラグイン内容
2. InitIncomingCall
3. ExitIncomingCall
4. IncomingCall
5. InKeyCallback
6. InKeyInitalize
7. InKeyTerminate
8. RingingStart
9. RingingEnd
10.IsDTMFSoundSilent
11.InKeyWndProc
プラグイン内容
エイジフォンでは 、プラグインによって機能を拡張できます。 プラグインはDLL形式で、インストールフォルダに置く必要があります。
現在公開しているプラグインは次の物です。
InCC.DLL 着信時にどのような動作をするか決めることができます。 InKey.DLL 外部ダイヤル入力をタイマー割り込みにより取得します。
InitIncomingCall
InCC.DLL内で使う関数です。起動時に一度エイジフォンからコールされます。初期化などに使います。
戻り値
BOOL WINAPI InitIncomingCall() 正常終了時、0以外の値を返す。
例
__declspec(dllexport) BOOL WINAPI InitIncomingCall()
{
return TRUE;
}
ExitIncomingCall
InCC.DLL内で使う関数です。終了時に一度エイジフォンからコールされます。後処理などに使います。
void WINAPI ExitIncomingCall() 戻り値
なし。
例
__declspec(dllexport) void WINAPI ExitIncomingCall()
{
}
IncomingCall
InCC.DLL内で使う関数です。着信時と着信終了時エイジフォンからコールされます。かかってきた相手によって処理を割り振ることができます
int WINAPI IncomingCall(
int nID,
LPCTSTR pUserID,
LPCTSTR pDisplayname,
BOOL bStart
)戻り値
-1の時、エイジフォンに着信音を鳴らさせず着信を拒否します。
0の時、 エイジフォンを通常着信させます。
2の時、留守番電話モードで応答します。
引数
nID エイジフォン内部で管理している着信IDです。 pUserID 相手のユーザーIDです。多くの場合ここに電話番号が入ります。 pDisplayname 任意で付けられる名前です bStart 0の時、着信中ではなくなった事をしめします。0以外の時、着信された瞬間を意味しま
InKeyCallback
InKey.DLL内で使う関数です。100msecに一度エイジフォンからコールされます。
UINT WINAPI InKeyCallback() 戻り値
エイジフォンに渡すダイヤル番号（ボタン番号）。10000～の値は以下のボタンに割り当てられており、10000未満の値の場合、その値のキーボードイベントを発生させます。
#define ID_DIAL0 10000
#define ID_DIAL1 10001
#define ID_DIAL2 10002
#define ID_DIAL3 10003
#define ID_DIAL4 10004
#define ID_DIAL5 10005
#define ID_DIAL6 10006
#define ID_DIAL7 10007
#define ID_DIAL8 10008
#define ID_DIAL9 10009
#define ID_DIALSTAR 10010
#define ID_DIALHASH 10011
#define ID_LINE1 10012
#define ID_LINE2 10013
#define ID_LINE3 10014
#define ID_LINE4 10015
#define ID_LINE5 10016
#define ID_LINE6 10017
#define ID_LINE7 10018
#define ID_LINE8 10019
#define ID_LINE9 10020
#define ID_LINE10 10021
#define ID_BTN1 10022
#define ID_BTN2 10023
#define ID_BTN3 10024
#define ID_BTN4 10025
#define ID_BTN5 10026
#define ID_OPTION 10027
#define ID_WEBOPTION 10028
#define ID_BTN8 10029
#define ID_BTN9 10030
#define ID_BTN10 10031
#define ID_CLEAR 10032
#define ID_HELPBUTTON 10033
#define ID_CLOSE 10034
#define ID_CONNECT 10035
#define ID_APPEXIT 10036
#define ID_EXIT 10036
#define ID_HANGUP 10037
#define ID_MICMUTE 10038
#define ID_SPKMUTE 10039
#define ID_BACK 10040
#define ID_MICUP 10041
#define ID_MICDOWN 10042
#define ID_SPKUP 10043
#define ID_SPKDOWN 10044
#define ID_TRANSFER 10045
#define ID_CHANGESPEAKER 10046
#define ID_WEB1 10047
#define ID_WEB2 10048
#define ID_WEB3 10049
#define ID_INPUT 10050
#define ID_PHONE 10051
#define ID_REFRESH 10052
例__declspec(dllexport) UINT WINAPI InKeyCallback()
{
return 0; //入力無し
}
InKeyInitalize
InKey.DLL内で使う関数です。最初に一度エイジフォンからコールされます。
BOOL WINAPI InKeyInitalize(HWND hwnd) InKeyInitalize 引数
hwnd エイジフォンのウインドウハンドル
戻り値
初期化に成功した場合TRUEを返す
InKeyTerminate
InKey.DLL内で使う関数です。最後に一度エイジフォンからコールされます。
void WINAPI InKeyTerminate()
RingingStart
InKey.DLL内で使う関数です。着信時にエイジフォンからコールされます。
UINT WINAPI RingingStart(LPCTSTR pData, int nSize) 引数
pData エイジフォンから渡される着信時のデータが入っています。予約されています。
nSize エイジフォンから渡される着信時のデータのサイズが入っています。予約されています。
戻り値
0を返します
RingingEnd
InKey.DLL内で使う関数です。着信終了時にエイジフォンからコールされます。
void WINAPI RingingEnd()
IsDTMFSoundSilent
InKey.DLL内で使う関数です。GUI操作時にエイジフォンからコールされます。
BOOL IsDTMFSoundSilent() 戻り値
０～９＊＃を押したときにエイジフォン側で音をならさないようにする場合TRUEを返します。音を鳴らす場合はFALSEを返します。
InKeyWndProc
エイジフォンのWindowProc内からそのままコールされます。詳しくはMSDN内のWindowProcを参照してください。InKey.DLL内で使う関数です。エイジフォンのウインドウメッセージを処理できます。
void WINAPI InKeyWndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)