Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

511 lines
11 KiB

/*++ 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
);