summaryrefslogtreecommitdiff
path: root/plugins/ExternalAPI/m_voiceservice.h
blob: 97d971cbb6017dd49aabf5d1bf38cbbe9affbb09 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
/* 
Copyright (C) 2007-2009 Ricardo Pescuma Domenecci

This is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.

This is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Library General Public License for more details.

You should have received a copy of the GNU Library General Public
License along with this file; see the file license.txt.  If
not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.  
*/


#ifndef __M_VOICESERVICE_H__
# define __M_VOICESERVICE_H__


/*
This services are a mirror of the services/notifications in m_voice.h,
with the difference that that ones are to be used by protocols, and this ones
are to be used by plugins that can make calls to contacts in multiple protocols.

To get the devices for input/output and some options, query the db directly:
 VoiceService/EchoCancelation	BYTE		default: TRUE
 VoiceService/MicBoost			BYTE		default: TRUE
 VoiceService/Input				TString		default: windows default
 VoiceService/Output			TString		default: windows default
*/


struct VOICE_MODULE
{
	int cbSize;           // sizeof(VOICE_MODULE)
	TCHAR *description;   // The description of the voice provider. This is the name that will be shown to the user
	const char *name;     // The internal name of the voice provider. All PS_* serivces
		                   // defined in m_voice.h need to be created based in this name. For example, 
                         // PS_VOICE_CALL (/Voice/Call) need to be created as <name>/Voice/Call
	HANDLE icon;          // Icon to identify provider (from icolib)
	int flags;            // or of VOICE_CAPS_*. You don't need to send VOICE_CAPS_VOICE.
};
/*
Register a new plugin that can make/receive voice calls (a voice provider).

wParam: const VOICE_MODULE *
lParam: ignored
return: 0 on success
*/
#define MS_VOICESERVICE_REGISTER		"VoiceService/Register"

/*
Unregister a plugin that can make/receive voice calls (a voice provider).

wParam: (const char *) Provider name
lParam: ignored
return: 0 on success
*/
#define MS_VOICESERVICE_UNREGISTER		"VoiceService/Unregister"

/*
Request a voice call to hContact.

wParam: (HANDLE) hContact
lParam: ignored
return: the number of option calls for a contact. If > 0, it can be called
*/
#define MS_VOICESERVICE_CAN_CALL			"VoiceService/CanCall"

/*
Request a voice call to hContact.

wParam: (HANDLE) hContact
lParam: (char *) Voice provider or NULL to use any provider avaiable
return: 0 on success
*/
#define MS_VOICESERVICE_CALL				"VoiceService/Call"



#endif // __M_VOICESERVICE_H__