512 lines
11 KiB
C
512 lines
11 KiB
C
|
/*++ BUILD Version: 0000 // Increment this if a change has global effects
|
||
|
|
|
||
|
|
Copyright (c) 1994-1998 Microsoft Corporation
|
||
|
|
|
||
|
|
Module Name:
|
||
|
|
|
||
|
|
client.h
|
||
|
|
|
||
|
|
Abstract:
|
||
|
|
|
||
|
|
Header file for tapi client module
|
||
|
|
|
||
|
|
Author:
|
||
|
|
|
||
|
|
Dan Knudson (DanKn) 01-Apr-1994
|
||
|
|
|
||
|
|
Revision History:
|
||
|
|
|
||
|
|
--*/
|
||
|
|
|
||
|
|
|
||
|
|
#define TAPI_VERSION1_0 0x00010003
|
||
|
|
#define TAPI_VERSION1_4 0x00010004
|
||
|
|
#define TAPI_VERSION2_0 0x00020000
|
||
|
|
#define TAPI_VERSION2_1 0x00020001
|
||
|
|
#define TAPI_VERSION2_2 0x00020002
|
||
|
|
#define TAPI_VERSION3_0 0x00030000
|
||
|
|
#define TAPI_VERSION_CURRENT TAPI_VERSION3_0
|
||
|
|
|
||
|
|
#define NUM_ARGS_MASK 0x0000000f
|
||
|
|
|
||
|
|
#define LINE_FUNC 0x00000010
|
||
|
|
#define PHONE_FUNC 0x00000020
|
||
|
|
#define TAPI_FUNC 0x00000000
|
||
|
|
|
||
|
|
#define ASYNC 0x00000040
|
||
|
|
#define SYNC 0x00000000
|
||
|
|
|
||
|
|
#define INITDATA_KEY ((DWORD) 'INIT')
|
||
|
|
#define TPROXYREQUESTHEADER_KEY ((DWORD) 'REQH')
|
||
|
|
|
||
|
|
#define WM_ASYNCEVENT (WM_USER+111)
|
||
|
|
|
||
|
|
#define DEF_NUM_EVENT_BUFFER_ENTRIES 16
|
||
|
|
|
||
|
|
#define TAPI_SUCCESS 0
|
||
|
|
#define TAPI_NO_DATA -1
|
||
|
|
#define MAX_TAPI_FUNC_ARGS 13
|
||
|
|
|
||
|
|
#define REMOVEPROVIDER 0
|
||
|
|
#define CONFIGPROVIDER 1
|
||
|
|
#define ADDPROVIDER 2
|
||
|
|
#define TAPI16BITSUCCESS -2
|
||
|
|
|
||
|
|
#define INITIAL_CLIENT_THREAD_BUF_SIZE 512
|
||
|
|
#define WM_TAPI16_CALLBACKMSG (WM_USER+101)
|
||
|
|
|
||
|
|
#define IsOnlyOneBitSetInDWORD(dw) (dw && !(((DWORD)dw) & (((DWORD)dw) - 1)))
|
||
|
|
|
||
|
|
#define AllCallSelect \
|
||
|
|
(LINECALLSELECT_CALL | \
|
||
|
|
LINECALLSELECT_ADDRESS | \
|
||
|
|
LINECALLSELECT_LINE)
|
||
|
|
|
||
|
|
#define AllDigitModes \
|
||
|
|
(LINEDIGITMODE_PULSE | \
|
||
|
|
LINEDIGITMODE_DTMF | \
|
||
|
|
LINEDIGITMODE_DTMFEND)
|
||
|
|
|
||
|
|
#define AllForwardModes \
|
||
|
|
(LINEFORWARDMODE_UNCOND | \
|
||
|
|
LINEFORWARDMODE_UNCONDINTERNAL | \
|
||
|
|
LINEFORWARDMODE_UNCONDEXTERNAL | \
|
||
|
|
LINEFORWARDMODE_UNCONDSPECIFIC | \
|
||
|
|
LINEFORWARDMODE_BUSY | \
|
||
|
|
LINEFORWARDMODE_BUSYINTERNAL | \
|
||
|
|
LINEFORWARDMODE_BUSYEXTERNAL | \
|
||
|
|
LINEFORWARDMODE_BUSYSPECIFIC | \
|
||
|
|
LINEFORWARDMODE_NOANSW | \
|
||
|
|
LINEFORWARDMODE_NOANSWINTERNAL | \
|
||
|
|
LINEFORWARDMODE_NOANSWEXTERNAL | \
|
||
|
|
LINEFORWARDMODE_NOANSWSPECIFIC | \
|
||
|
|
LINEFORWARDMODE_BUSYNA | \
|
||
|
|
LINEFORWARDMODE_BUSYNAINTERNAL | \
|
||
|
|
LINEFORWARDMODE_BUSYNAEXTERNAL | \
|
||
|
|
LINEFORWARDMODE_BUSYNASPECIFIC)
|
||
|
|
|
||
|
|
#define AllTerminalModes \
|
||
|
|
(LINETERMMODE_BUTTONS | \
|
||
|
|
LINETERMMODE_LAMPS | \
|
||
|
|
LINETERMMODE_DISPLAY | \
|
||
|
|
LINETERMMODE_RINGER | \
|
||
|
|
LINETERMMODE_HOOKSWITCH | \
|
||
|
|
LINETERMMODE_MEDIATOLINE | \
|
||
|
|
LINETERMMODE_MEDIAFROMLINE | \
|
||
|
|
LINETERMMODE_MEDIABIDIRECT)
|
||
|
|
|
||
|
|
#define AllToneModes \
|
||
|
|
(LINETONEMODE_CUSTOM | \
|
||
|
|
LINETONEMODE_RINGBACK | \
|
||
|
|
LINETONEMODE_BUSY | \
|
||
|
|
LINETONEMODE_BEEP | \
|
||
|
|
LINETONEMODE_BILLING)
|
||
|
|
|
||
|
|
#define AllHookSwitchDevs \
|
||
|
|
(PHONEHOOKSWITCHDEV_HANDSET | \
|
||
|
|
PHONEHOOKSWITCHDEV_SPEAKER | \
|
||
|
|
PHONEHOOKSWITCHDEV_HEADSET)
|
||
|
|
|
||
|
|
#define AllHookSwitchModes \
|
||
|
|
(PHONEHOOKSWITCHMODE_ONHOOK | \
|
||
|
|
PHONEHOOKSWITCHMODE_MIC | \
|
||
|
|
PHONEHOOKSWITCHMODE_SPEAKER | \
|
||
|
|
PHONEHOOKSWITCHMODE_MICSPEAKER)
|
||
|
|
|
||
|
|
#define AllLampModes \
|
||
|
|
(PHONELAMPMODE_BROKENFLUTTER | \
|
||
|
|
PHONELAMPMODE_FLASH | \
|
||
|
|
PHONELAMPMODE_FLUTTER | \
|
||
|
|
PHONELAMPMODE_OFF | \
|
||
|
|
PHONELAMPMODE_STEADY | \
|
||
|
|
PHONELAMPMODE_WINK | \
|
||
|
|
PHONELAMPMODE_DUMMY)
|
||
|
|
|
||
|
|
#define AllMediaModes \
|
||
|
|
(LINEMEDIAMODE_UNKNOWN | \
|
||
|
|
LINEMEDIAMODE_INTERACTIVEVOICE | \
|
||
|
|
LINEMEDIAMODE_AUTOMATEDVOICE | \
|
||
|
|
LINEMEDIAMODE_DIGITALDATA | \
|
||
|
|
LINEMEDIAMODE_G3FAX | \
|
||
|
|
LINEMEDIAMODE_G4FAX | \
|
||
|
|
LINEMEDIAMODE_DATAMODEM | \
|
||
|
|
LINEMEDIAMODE_TELETEX | \
|
||
|
|
LINEMEDIAMODE_VIDEOTEX | \
|
||
|
|
LINEMEDIAMODE_TELEX | \
|
||
|
|
LINEMEDIAMODE_MIXED | \
|
||
|
|
LINEMEDIAMODE_TDD | \
|
||
|
|
LINEMEDIAMODE_ADSI | \
|
||
|
|
LINEMEDIAMODE_VOICEVIEW | \
|
||
|
|
LINEMEDIAMODE_VIDEO)
|
||
|
|
|
||
|
|
|
||
|
|
typedef enum
|
||
|
|
{
|
||
|
|
xGetAsyncEvents,
|
||
|
|
xGetUIDllName,
|
||
|
|
xUIDLLCallback,
|
||
|
|
xFreeDialogInstance,
|
||
|
|
|
||
|
|
lAccept,
|
||
|
|
lAddToConference,
|
||
|
|
lAgentSpecific,
|
||
|
|
lAnswer,
|
||
|
|
lBlindTransfer,
|
||
|
|
lClose,
|
||
|
|
lCompleteCall,
|
||
|
|
lCompleteTransfer,
|
||
|
|
// lConditionalMediaDetection, //remotesp
|
||
|
|
lDeallocateCall,
|
||
|
|
lDevSpecific,
|
||
|
|
lDevSpecificFeature,
|
||
|
|
lDial,
|
||
|
|
lDrop,
|
||
|
|
lForward,
|
||
|
|
lGatherDigits,
|
||
|
|
lGenerateDigits,
|
||
|
|
lGenerateTone,
|
||
|
|
lGetAddressCaps,
|
||
|
|
lGetAddressID,
|
||
|
|
lGetAddressStatus,
|
||
|
|
lGetAgentActivityList,
|
||
|
|
lGetAgentCaps,
|
||
|
|
lGetAgentGroupList,
|
||
|
|
lGetAgentStatus,
|
||
|
|
lGetAppPriority,
|
||
|
|
lGetCallAddressID, // remotesp only
|
||
|
|
lGetCallInfo,
|
||
|
|
lGetCallStatus,
|
||
|
|
lGetConfRelatedCalls,
|
||
|
|
lGetCountry,
|
||
|
|
lGetDevCaps,
|
||
|
|
lGetDevConfig,
|
||
|
|
lGetIcon,
|
||
|
|
lGetID,
|
||
|
|
lGetLineDevStatus,
|
||
|
|
lGetNewCalls,
|
||
|
|
lGetNumAddressIDs, // remotesp only
|
||
|
|
lGetNumRings,
|
||
|
|
lGetProviderList,
|
||
|
|
lGetRequest,
|
||
|
|
lGetStatusMessages,
|
||
|
|
//In TAPI32.DLL now: lGetTranslateCaps,
|
||
|
|
lHandoff,
|
||
|
|
lHold,
|
||
|
|
lInitialize,
|
||
|
|
lMakeCall,
|
||
|
|
lMonitorDigits,
|
||
|
|
lMonitorMedia,
|
||
|
|
lMonitorTones,
|
||
|
|
lNegotiateAPIVersion,
|
||
|
|
lNegotiateExtVersion,
|
||
|
|
lOpen,
|
||
|
|
lPark,
|
||
|
|
lPickup,
|
||
|
|
lPrepareAddToConference,
|
||
|
|
lProxyMessage,
|
||
|
|
lProxyResponse,
|
||
|
|
lRedirect,
|
||
|
|
lRegisterRequestRecipient,
|
||
|
|
lReleaseUserUserInfo,
|
||
|
|
lRemoveFromConference,
|
||
|
|
lSecureCall,
|
||
|
|
// lSelectExtVersion,
|
||
|
|
lSendUserUserInfo,
|
||
|
|
lSetAgentActivity,
|
||
|
|
lSetAgentGroup,
|
||
|
|
lSetAgentState,
|
||
|
|
lSetAppPriority,
|
||
|
|
lSetAppSpecific,
|
||
|
|
lSetCallData,
|
||
|
|
lSetCallParams,
|
||
|
|
lSetCallPrivilege,
|
||
|
|
lSetCallQualityOfService,
|
||
|
|
lSetCallTreatment,
|
||
|
|
//In TAPI32.DLL now: lSetCurrentLocation,
|
||
|
|
lSetDefaultMediaDetection, // remotesp only
|
||
|
|
lSetDevConfig,
|
||
|
|
lSetLineDevStatus,
|
||
|
|
lSetMediaControl,
|
||
|
|
lSetMediaMode,
|
||
|
|
lSetNumRings,
|
||
|
|
lSetStatusMessages,
|
||
|
|
lSetTerminal,
|
||
|
|
//In TAPI32.DLL now: lSetTollList,
|
||
|
|
lSetupConference,
|
||
|
|
lSetupTransfer,
|
||
|
|
lShutdown,
|
||
|
|
lSwapHold,
|
||
|
|
//In TAPI32.DLL now: lTranslateAddress,
|
||
|
|
lUncompleteCall,
|
||
|
|
lUnhold,
|
||
|
|
lUnpark,
|
||
|
|
|
||
|
|
pClose,
|
||
|
|
pDevSpecific,
|
||
|
|
pGetButtonInfo,
|
||
|
|
pGetData,
|
||
|
|
pGetDevCaps,
|
||
|
|
pGetDisplay,
|
||
|
|
pGetGain,
|
||
|
|
pGetHookSwitch,
|
||
|
|
pGetID,
|
||
|
|
pGetIcon,
|
||
|
|
pGetLamp,
|
||
|
|
pGetRing,
|
||
|
|
pGetStatus,
|
||
|
|
pGetStatusMessages,
|
||
|
|
pGetVolume,
|
||
|
|
pInitialize,
|
||
|
|
pOpen,
|
||
|
|
pNegotiateAPIVersion,
|
||
|
|
pNegotiateExtVersion,
|
||
|
|
// pSelectExtVersion, // remotesp
|
||
|
|
pSetButtonInfo,
|
||
|
|
pSetData,
|
||
|
|
pSetDisplay,
|
||
|
|
pSetGain,
|
||
|
|
pSetHookSwitch,
|
||
|
|
pSetLamp,
|
||
|
|
pSetRing,
|
||
|
|
pSetStatusMessages,
|
||
|
|
pSetVolume,
|
||
|
|
pShutdown,
|
||
|
|
|
||
|
|
//In TAPI32.DLL now: tGetLocationInfo,
|
||
|
|
tRequestDrop,
|
||
|
|
tRequestMakeCall,
|
||
|
|
tRequestMediaCall,
|
||
|
|
// tMarkLineEvent,
|
||
|
|
tReadLocations,
|
||
|
|
tWriteLocations,
|
||
|
|
tAllocNewID,
|
||
|
|
tPerformance,
|
||
|
|
lConditionalMediaDetection, //remotesp
|
||
|
|
lSelectExtVersion,
|
||
|
|
pSelectExtVersion, // remotesp
|
||
|
|
// lOpenInt,
|
||
|
|
// lShutdownInt,
|
||
|
|
|
||
|
|
//
|
||
|
|
// Ordinals for tapi 2.1 ended here. the lOpenInt & lShutdownInt
|
||
|
|
// were Win95 local-machine-only hacks which have since been removed
|
||
|
|
//
|
||
|
|
|
||
|
|
xNegotiateAPIVersionForAllDevices, // remotesp
|
||
|
|
|
||
|
|
mGetAvailableProviders,
|
||
|
|
mGetLineInfo,
|
||
|
|
mGetPhoneInfo,
|
||
|
|
mGetServerConfig,
|
||
|
|
mSetLineInfo,
|
||
|
|
mSetPhoneInfo,
|
||
|
|
mSetServerConfig,
|
||
|
|
|
||
|
|
//
|
||
|
|
// Ordinals for 2.1 update (nt4 sp4) ended here.
|
||
|
|
//
|
||
|
|
|
||
|
|
lMSPIdentify,
|
||
|
|
lReceiveMSPData,
|
||
|
|
|
||
|
|
lGetCallHubTracking,
|
||
|
|
lGetCallIDs,
|
||
|
|
lGetHubRelatedCalls,
|
||
|
|
lSetCallHubTracking,
|
||
|
|
xPrivateFactoryIdentify,
|
||
|
|
lDevSpecificEx,
|
||
|
|
lCreateAgent,
|
||
|
|
lCreateAgentSession,
|
||
|
|
lGetAgentInfo,
|
||
|
|
lGetAgentSessionInfo,
|
||
|
|
lGetAgentSessionList,
|
||
|
|
lGetQueueInfo,
|
||
|
|
lGetGroupList,
|
||
|
|
lGetQueueList,
|
||
|
|
lSetAgentMeasurementPeriod,
|
||
|
|
lSetAgentSessionState,
|
||
|
|
lSetQueueMeasurementPeriod,
|
||
|
|
lSetAgentStateEx,
|
||
|
|
lGetProxyStatus,
|
||
|
|
lCreateMSPInstance,
|
||
|
|
lCloseMSPInstance,
|
||
|
|
|
||
|
|
//
|
||
|
|
// The following is always the last one in the list
|
||
|
|
//
|
||
|
|
|
||
|
|
xLastFunc
|
||
|
|
|
||
|
|
} FUNC_TYPE;
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct _CLIENT_THREAD_INFO
|
||
|
|
{
|
||
|
|
LIST_ENTRY TlsList;
|
||
|
|
|
||
|
|
LPBYTE pBuf;
|
||
|
|
|
||
|
|
DWORD dwBufSize;
|
||
|
|
|
||
|
|
} CLIENT_THREAD_INFO, *PCLIENT_THREAD_INFO;
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct _TAPI32_MSG
|
||
|
|
{
|
||
|
|
//
|
||
|
|
// The following union is used:
|
||
|
|
//
|
||
|
|
// 1. by requests from client to server to specify a function type
|
||
|
|
// 2. by acks from server to client to specify a return value
|
||
|
|
// 3. by async msgs from server to client to specify msg type
|
||
|
|
//
|
||
|
|
|
||
|
|
union
|
||
|
|
{
|
||
|
|
DWORD Req_Func;
|
||
|
|
|
||
|
|
LONG_PTR Ack_ReturnValue;
|
||
|
|
|
||
|
|
DWORD Msg_Type;
|
||
|
|
|
||
|
|
} u;
|
||
|
|
|
||
|
|
|
||
|
|
//
|
||
|
|
// The following...
|
||
|
|
//
|
||
|
|
|
||
|
|
ULONG_PTR hRpcClientInst;
|
||
|
|
|
||
|
|
|
||
|
|
//
|
||
|
|
// Function paramters
|
||
|
|
//
|
||
|
|
|
||
|
|
ULONG_PTR Params[MAX_TAPI_FUNC_ARGS];
|
||
|
|
|
||
|
|
} TAPI32_MSG, *PTAPI32_MSG;
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct _ASYNCEVENTMSG
|
||
|
|
{
|
||
|
|
ULONG_PTR TotalSize;
|
||
|
|
ULONG_PTR InitContext;
|
||
|
|
ULONG_PTR pfnPostProcessProc;
|
||
|
|
ULONG_PTR hDevice;
|
||
|
|
|
||
|
|
ULONG_PTR Msg;
|
||
|
|
ULONG_PTR OpenContext;
|
||
|
|
ULONG_PTR Param1;
|
||
|
|
ULONG_PTR Param2;
|
||
|
|
|
||
|
|
ULONG_PTR Param3;
|
||
|
|
ULONG_PTR Param4;
|
||
|
|
|
||
|
|
} ASYNCEVENTMSG, *PASYNCEVENTMSG;
|
||
|
|
|
||
|
|
|
||
|
|
typedef void (PASCAL *POSTPROCESSPROC)(PASYNCEVENTMSG pMsg);
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct _ASYNC_EVENT_PARAMS
|
||
|
|
{
|
||
|
|
DWORD hDevice;
|
||
|
|
DWORD dwMsg;
|
||
|
|
ULONG_PTR dwCallbackInstance;
|
||
|
|
ULONG_PTR dwParam1;
|
||
|
|
|
||
|
|
ULONG_PTR dwParam2;
|
||
|
|
ULONG_PTR dwParam3;
|
||
|
|
|
||
|
|
} ASYNC_EVENT_PARAMS, *PASYNC_EVENT_PARAMS;
|
||
|
|
|
||
|
|
|
||
|
|
typedef LONG (PASCAL *TUISPIPROC)();
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct _UITHREADDATA
|
||
|
|
{
|
||
|
|
HTAPIDIALOGINSTANCE htDlgInst;
|
||
|
|
HINSTANCE hUIDll;
|
||
|
|
HANDLE hThread;
|
||
|
|
HANDLE hEvent;
|
||
|
|
|
||
|
|
LPVOID pParams;
|
||
|
|
DWORD dwSize;
|
||
|
|
TUISPIPROC pfnTUISPI_providerGenericDialog;
|
||
|
|
TUISPIPROC pfnTUISPI_providerGenericDialogData;
|
||
|
|
|
||
|
|
struct _UITHREADDATA *pPrev;
|
||
|
|
struct _UITHREADDATA *pNext;
|
||
|
|
|
||
|
|
} UITHREADDATA, *PUITHREADDATA;
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct _PROXYREQUESTHEADER
|
||
|
|
{
|
||
|
|
DWORD dwKey;
|
||
|
|
|
||
|
|
DWORD dwInstance;
|
||
|
|
|
||
|
|
} PROXYREQUESTHEADER, *PPROXYREQUESTHEADER;
|
||
|
|
|
||
|
|
|
||
|
|
#if DBG
|
||
|
|
extern char gszDebug[];
|
||
|
|
#endif
|
||
|
|
//extern const char gszLocation[];
|
||
|
|
//extern const char gszLocations[];
|
||
|
|
extern const char gszCurrentLocation[];
|
||
|
|
extern const CHAR gszNullString[];
|
||
|
|
|
||
|
|
|
||
|
|
#if DBG
|
||
|
|
#define ClientAlloc( __size__ ) ClientAllocReal( __size__, __LINE__, __FILE__ )
|
||
|
|
|
||
|
|
LPVOID
|
||
|
|
WINAPI
|
||
|
|
ClientAllocReal(
|
||
|
|
DWORD dwSize,
|
||
|
|
DWORD dwLine,
|
||
|
|
PSTR pszFile
|
||
|
|
);
|
||
|
|
|
||
|
|
#else
|
||
|
|
#define ClientAlloc( __size__ ) ClientAllocReal( __size__ )
|
||
|
|
|
||
|
|
LPVOID
|
||
|
|
WINAPI
|
||
|
|
ClientAllocReal(
|
||
|
|
DWORD dwSize
|
||
|
|
);
|
||
|
|
|
||
|
|
#endif
|
||
|
|
|
||
|
|
SIZE_T
|
||
|
|
WINAPI
|
||
|
|
ClientSize(
|
||
|
|
LPVOID lp
|
||
|
|
);
|
||
|
|
|
||
|
|
void
|
||
|
|
WINAPI
|
||
|
|
ClientFree(
|
||
|
|
LPVOID lp
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
LONG
|
||
|
|
WINAPI
|
||
|
|
MarkLineEvent(
|
||
|
|
DWORD dwApiVersion,
|
||
|
|
DWORD ptLine,
|
||
|
|
DWORD ptLineClientToExclude,
|
||
|
|
DWORD dwMsg,
|
||
|
|
DWORD dwParam1,
|
||
|
|
DWORD dwParam2,
|
||
|
|
DWORD dwParam3
|
||
|
|
);
|