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.
 
 
 
 
 
 

319 lines
9.2 KiB

/*++
Copyright (c) 1997 Microsoft Corporation
Module Name:
call.h
Abstract:
Definitions for H.323 TAPI Service Provider call objects.
Environment:
User Mode - Win32
Revision History:
--*/
#ifndef _INC_CALL
#define _INC_CALL
///////////////////////////////////////////////////////////////////////////////
// //
// Header files //
// //
///////////////////////////////////////////////////////////////////////////////
#include "channel.h"
///////////////////////////////////////////////////////////////////////////////
// //
// Type definitions //
// //
///////////////////////////////////////////////////////////////////////////////
typedef enum _H323_CALLSTATE {
H323_CALLSTATE_ALLOCATED = 0,
H323_CALLSTATE_IN_USE
} H323_CALLSTATE, *PH323_CALLSTATE;
typedef struct _H323_U2ULE {
LIST_ENTRY Link;
DWORD dwU2USize;
PBYTE pU2U;
} H323_U2ULE, *PH323_U2ULE;
typedef struct _H323_CALL {
HDRVCALL hdCall; // tspi call handle
HTAPICALL htCall; // tapi call handle
CC_HCALL hccCall; // intelcc call handle
CC_HCONFERENCE hccConf; // intelcc conf handle
H323_CALLSTATE nState; // state of call object
DWORD dwCallState; // tspi call state
DWORD dwCallStateMode; // tspi call state mode
DWORD dwOrigin; // inbound or outbound
DWORD dwAddressType; // type of dst address
DWORD dwIncomingModes; // available media modes
DWORD dwOutgoingModes; // available media modes
DWORD dwRequestedModes; // requested media modes
DWORD dwAppSpecific;
BOOL fMonitoringDigits; // listening for dtmf flag
DWORD dwLinkSpeed; // speed of network connection
LIST_ENTRY IncomingU2U; // incoming user user messages
LIST_ENTRY OutgoingU2U; // outgoing user user messages
CC_ADDR ccCalleeAddr; // intelcc src address
CC_ADDR ccCallerAddr; // intelcc dst address
CC_ALIASITEM ccCalleeAlias; // intelcc src alias
CC_ALIASITEM ccCallerAlias; // intelcc dst alias
CC_TERMCAP ccRemoteAudioCaps; // remote party audio
CC_TERMCAP ccRemoteVideoCaps; // remote party video
PH323_CHANNEL_TABLE pChannelTable; // table of logical channels
struct _H323_LINE * pLine; // pointer to containing line
} H323_CALL, *PH323_CALL;
typedef struct _H323_CALL_TABLE {
DWORD dwNumSlots; // number of entries
DWORD dwNumInUse; // number of entries in use
DWORD dwNumAllocated; // number of entries allocated
DWORD dwNextAvailable; // next available table index
PH323_CALL pCalls[ANYSIZE]; // array of object pointers
} H323_CALL_TABLE, *PH323_CALL_TABLE;
///////////////////////////////////////////////////////////////////////////////
// //
// Public prototypes //
// //
///////////////////////////////////////////////////////////////////////////////
BOOL
H323BindCall(
PH323_CALL pCall,
PCC_CONFERENCEID pConferenceID
);
BOOL
H323UnbindCall(
PH323_CALL pCall
);
BOOL
H323PlaceCall(
PH323_CALL pCall
);
BOOL
H323HangupCall(
PH323_CALL pCall
);
BOOL
H323CloseCall(
PH323_CALL pCall
);
BOOL
H323DropCall(
PH323_CALL pCall,
DWORD dwDisconnectMode
);
BOOL
H323GetCallAndLock(
PH323_CALL * ppCall,
HDRVCALL hdCall
);
BOOL
H323GetCallByHCall(
PH323_CALL * ppCall,
struct _H323_LINE * pLine,
CC_HCALL hccCall
);
BOOL
H323ChangeCallState(
PH323_CALL pCall,
DWORD dwCallState,
DWORD dwCallStateMode
);
BOOL
H323ChangeCallStateToIdle(
PH323_CALL pCall,
DWORD dwDisconnectMode
);
BOOL
H323AllocCallTable(
PH323_CALL_TABLE * ppCallTable
);
BOOL
H323FreeCallTable(
PH323_CALL_TABLE pCallTable
);
BOOL
H323CloseCallTable(
PH323_CALL_TABLE pCallTable
);
BOOL
H323AllocCallFromTable(
PH323_CALL * ppCall,
PH323_CALL_TABLE * ppCallTable,
struct _H323_LINE * pLine
);
BOOL
H323FreeCallFromTable(
PH323_CALL pCall,
PH323_CALL_TABLE pCallTable
);
BOOL
H323UpdateMediaModes(
PH323_CALL pCall
);
BOOL
H323AcceptCall(
PH323_CALL pCall
);
BOOL
H323AddU2U(
PLIST_ENTRY pListHead,
DWORD dwDataSize,
PBYTE pData
);
BOOL
H323RemoveU2U(
PLIST_ENTRY pListHead,
PH323_U2ULE * ppU2ULE
);
DWORD
H323DetermineLinkSpeed(
DWORD dwHostAddr
);
BOOL
H323GetTermCapList(
PH323_CALL pCall,
PCC_TERMCAPLIST pTermCapList,
PCC_TERMCAPDESCRIPTORS pTermCapDescriptors
);
///////////////////////////////////////////////////////////////////////////////
// //
// Call capabilites //
// //
///////////////////////////////////////////////////////////////////////////////
#define H323_CALL_INBOUNDSTATES (LINECALLSTATE_ACCEPTED | \
LINECALLSTATE_CONNECTED | \
LINECALLSTATE_DISCONNECTED | \
LINECALLSTATE_IDLE | \
LINECALLSTATE_OFFERING)
#define H323_CALL_OUTBOUNDSTATES (LINECALLSTATE_CONNECTED | \
LINECALLSTATE_DIALING | \
LINECALLSTATE_DISCONNECTED | \
LINECALLSTATE_IDLE | \
LINECALLSTATE_RINGBACK)
///////////////////////////////////////////////////////////////////////////////
// //
// Macros //
// //
///////////////////////////////////////////////////////////////////////////////
#define H323IsCallAllocated(_pCall_) \
((_pCall_) != NULL)
#define H323IsCallInUse(_pCall_) \
(H323IsCallAllocated(_pCall_) && \
((_pCall_)->nState > H323_CALLSTATE_ALLOCATED))
#define H323IsCallEqual(_pCall_,_hdCall_) \
(H323IsCallInUse(_pCall_) && \
((_pCall_)->hdCall == (_hdCall_)))
#define H323IsCallActive(_pCall_) \
(((_pCall_)->dwCallState != LINECALLSTATE_IDLE) && \
((_pCall_)->dwCallState != LINECALLSTATE_DISCONNECTED))
#define H323IsCallIdle(_pCall_) \
((_pCall_)->dwCallState == LINECALLSTATE_IDLE)
#define H323IsCallDisconnected(_pCall_) \
((_pCall_)->dwCallState == LINECALLSTATE_DISCONNECTED)
#define H323IsCallConnected(_pCall_) \
((_pCall_)->dwCallState == LINECALLSTATE_CONNECTED)
#define H323IsCallProceeding(_pCall_) \
(((_pCall_)->dwCallState == LINECALLSTATE_DIALING) || \
((_pCall_)->dwCallState == LINECALLSTATE_RINGBACK))
#define H323IsCallOffering(_pCall_) \
((_pCall_)->dwCallState == LINECALLSTATE_OFFERING)
#define H323IsCallInbound(_pCall_) \
((_pCall_)->dwOrigin == LINECALLORIGIN_INBOUND)
#define H323GetCallFeatures(_pCall_) \
(((_pCall_)->dwCallState != LINECALLSTATE_IDLE) \
? LINECALLFEATURE_DROP \
: 0)
#define H323GetLineHandle(_hdCall_) \
((HDRVLINE)(DWORD)HIWORD((DWORD)(_hdCall_)))
#define H323GetCallTableIndex(_hdCall_) \
((DWORD)LOWORD((DWORD)(_hdCall_)))
#define H323CreateCallHandle(_hdLine_,_i_) \
((HDRVCALL)MAKELONG(LOWORD((DWORD)(_i_)),LOWORD((DWORD)(_hdLine_))))
#define H323IsVideoRequested(_pCall_) \
((_pCall_)->dwRequestedModes & LINEMEDIAMODE_VIDEO)
#define H323IsAutomatedVoiceRequested(_pCall_) \
((_pCall_)->dwRequestedModes & LINEMEDIAMODE_AUTOMATEDVOICE)
#define H323IsInteractiveVoiceRequested(_pCall_) \
((_pCall_)->dwRequestedModes & LINEMEDIAMODE_INTERACTIVEVOICE)
#define H323IsMediaUnresolved(_pCall_) \
((_pCall_)->dwOutgoingModes & LINEMEDIAMODE_UNKNOWN)
#define H323IsAudioRequested(_pCall_) \
(H323IsAutomatedVoiceRequested(_pCall_) || \
H323IsInteractiveVoiceRequested(_pCall_))
#endif // _INC_CALL