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.
 
 
 
 
 
 

629 lines
21 KiB

/*++
Copyright (c) 1997 Microsoft Corporation
Module Name:
termcaps.c
Abstract:
Routines for handling terminal capabilities.
Environment:
User Mode - Win32
--*/
///////////////////////////////////////////////////////////////////////////////
// //
// Include files //
// //
///////////////////////////////////////////////////////////////////////////////
#include "globals.h"
#include "termcaps.h"
#include "call.h"
///////////////////////////////////////////////////////////////////////////////
// //
// Global variables //
// //
///////////////////////////////////////////////////////////////////////////////
H245_TOTCAP_T g_TermCapG723;
H245_TOTCAP_T g_TermCapG711ULaw64;
H245_TOTCAP_T g_TermCapG711ALaw64;
H245_TOTCAP_T g_TermCapH261;
H245_TOTCAP_T g_TermCapT120;
H245_TOTCAP_T g_TermCapH263_28800;
H245_TOTCAP_T g_TermCapH263_35000;
H245_TOTCAP_T g_TermCapH263_42000;
H245_TOTCAP_T g_TermCapH263_49000;
H245_TOTCAP_T g_TermCapH263_56000;
H245_TOTCAP_T g_TermCapH263_ISDN;
H245_TOTCAP_T g_TermCapH263_LAN;
PCC_TERMCAP g_TermCapArray_14400[] = {
&g_TermCapG723
};
PCC_TERMCAP g_TermCapArray_28800[] = {
&g_TermCapG723,
&g_TermCapH263_28800,
&g_TermCapT120
};
PCC_TERMCAP g_TermCapArray_35000[] = {
&g_TermCapG723,
&g_TermCapH263_35000,
&g_TermCapT120
};
PCC_TERMCAP g_TermCapArray_42000[] = {
&g_TermCapG723,
&g_TermCapH263_42000,
&g_TermCapT120
};
PCC_TERMCAP g_TermCapArray_49000[] = {
&g_TermCapG723,
&g_TermCapH263_49000,
&g_TermCapT120
};
PCC_TERMCAP g_TermCapArray_56000[] = {
&g_TermCapG723,
&g_TermCapH263_56000,
&g_TermCapT120
};
PCC_TERMCAP g_TermCapArray_ISDN[] = {
&g_TermCapG723,
&g_TermCapH263_ISDN,
&g_TermCapT120
};
PCC_TERMCAP g_TermCapArray_LAN[] = {
&g_TermCapG723,
&g_TermCapH263_LAN,
&g_TermCapG711ULaw64,
&g_TermCapG711ALaw64,
&g_TermCapH261,
&g_TermCapT120
};
// these must match the arrays above...
H245_TOTCAPDESC_T g_TermCapDescriptor_14400;
H245_TOTCAPDESC_T g_TermCapDescriptor_28800;
H245_TOTCAPDESC_T g_TermCapDescriptor_LAN;
H245_TOTCAPDESC_T * g_TermCapDArray_14400[] = {
&g_TermCapDescriptor_14400
};
H245_TOTCAPDESC_T * g_TermCapDArray_28800[] = {
&g_TermCapDescriptor_28800
};
// re-use g.723.1 and h.263 descriptors
H245_TOTCAPDESC_T * g_TermCapDArray_35000[] = {
&g_TermCapDescriptor_28800
};
// re-use g.723.1 and h.263 descriptors
H245_TOTCAPDESC_T * g_TermCapDArray_42000[] = {
&g_TermCapDescriptor_28800
};
// re-use g.723.1 and h.263 descriptors
H245_TOTCAPDESC_T * g_TermCapDArray_49000[] = {
&g_TermCapDescriptor_28800
};
// re-use g.723.1 and h.263 descriptors
H245_TOTCAPDESC_T * g_TermCapDArray_56000[] = {
&g_TermCapDescriptor_28800
};
// re-use g.723.1 and h.263 descriptors
H245_TOTCAPDESC_T * g_TermCapDArray_ISDN[] = {
&g_TermCapDescriptor_28800
};
H245_TOTCAPDESC_T * g_TermCapDArray_LAN[] = {
&g_TermCapDescriptor_LAN
};
CC_OCTETSTRING g_ProductID = {
H323_PRODUCT_ID,
sizeof(H323_PRODUCT_ID)
};
CC_OCTETSTRING g_ProductVersion = {
H323_PRODUCT_VERSION,
sizeof(H323_PRODUCT_VERSION)
};
CC_VENDORINFO g_VendorInfo = DEFINE_VENDORINFO(g_ProductID,g_ProductVersion);
// T.120 related data.
BOOL g_fAdvertiseT120 = FALSE;
DWORD g_dwIPT120 = INADDR_ANY;
WORD g_wPortT120 = 0;
// the enum H245_CAPABILITY is used as the index into this array,
DWORD g_CapabilityWeights[MAX_CAPS] = {100, 100, 100, 100};
///////////////////////////////////////////////////////////////////////////////
// //
// Private procedures //
// //
///////////////////////////////////////////////////////////////////////////////
BOOL
UpdateSimultaneousCapabilities(
)
/*++
Routine Description:
This function is called when the capabilities are changed by the app. The
array of caps and simcaps are updated based on the new status.
Arguments:
None.
Return Values:
Returns true if successful.
--*/
{
unsigned short ulNumArrays;
// initialize 14.4 descriptors
g_TermCapDescriptor_14400.CapDescId = 0;
ulNumArrays = 0;
if (g_CapabilityWeights[HC_G723] > 0)
{
g_TermCapDescriptor_14400.CapDesc.SimCapArray[ulNumArrays].Length = 1;
g_TermCapDescriptor_14400.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_G723;
ulNumArrays ++;
}
if (g_fAdvertiseT120)
{
g_TermCapDescriptor_14400.CapDesc.SimCapArray[ulNumArrays].Length = 1;
g_TermCapDescriptor_14400.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_T120;
ulNumArrays ++;
}
g_TermCapDescriptor_14400.CapDesc.Length = ulNumArrays;
// initialize 28.8 descriptors
g_TermCapDescriptor_28800.CapDescId = 0;
ulNumArrays = 0;
if (g_CapabilityWeights[HC_G723] > 0)
{
g_TermCapDescriptor_28800.CapDesc.SimCapArray[ulNumArrays].Length = 1;
g_TermCapDescriptor_28800.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_G723;
ulNumArrays ++;
}
if (g_CapabilityWeights[HC_H263QCIF] > 0)
{
g_TermCapDescriptor_28800.CapDesc.SimCapArray[ulNumArrays].Length = 1;
g_TermCapDescriptor_28800.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_H263;
ulNumArrays ++;
}
if (g_fAdvertiseT120)
{
g_TermCapDescriptor_28800.CapDesc.SimCapArray[ulNumArrays].Length = 1;
g_TermCapDescriptor_28800.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_T120;
ulNumArrays ++;
}
g_TermCapDescriptor_28800.CapDesc.Length = ulNumArrays;
// initialize LAN descriptors
g_TermCapDescriptor_LAN.CapDescId = 0;
ulNumArrays = 0;
if ((g_CapabilityWeights[HC_G723] > 0) && (g_CapabilityWeights[HC_G711] > 0))
{
// both G723 and G711 are selected.
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].Length = 3;
// decide witch one is prefered.
if (g_CapabilityWeights[HC_G723] >= g_CapabilityWeights[HC_G711])
{
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_G723;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[1] = H245_TERMCAPID_G711_ULAW64;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[2] = H245_TERMCAPID_G711_ALAW64;
}
else
{
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_G711_ULAW64;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[1] = H245_TERMCAPID_G711_ALAW64;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[2] = H245_TERMCAPID_G723;
}
ulNumArrays ++;
}
else if (g_CapabilityWeights[HC_G723] > 0)
{
// only G723 is selected.
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].Length = 1;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_G723;
ulNumArrays ++;
}
else if (g_CapabilityWeights[HC_G711] > 0)
{
// only G711 is selected.
g_TermCapDescriptor_LAN.CapDesc.Length ++;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].Length = 2;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_G711_ULAW64;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[1] = H245_TERMCAPID_G711_ALAW64;
ulNumArrays ++;
}
if ((g_CapabilityWeights[HC_H263QCIF] > 0) && (g_CapabilityWeights[HC_H261QCIF] > 0))
{
// both H261 and H263 are selected.
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].Length = 2;
// decide witch one is prefered.
if (g_CapabilityWeights[HC_H263QCIF] >= g_CapabilityWeights[HC_H261QCIF] > 0)
{
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_H263;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[1] = H245_TERMCAPID_H261;
}
else
{
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_H261;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[1] = H245_TERMCAPID_H263;
}
ulNumArrays ++;
}
else if (g_CapabilityWeights[HC_H263QCIF] > 0)
{
// Only H263 is selected.
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].Length = 1;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_H263;
ulNumArrays ++;
}
else if (g_CapabilityWeights[HC_H261QCIF] > 0)
{
// Only H263 is selected.
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].Length = 1;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_H261;
ulNumArrays ++;
}
if (g_fAdvertiseT120)
{
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].Length = 1;
g_TermCapDescriptor_LAN.CapDesc.SimCapArray[ulNumArrays].AltCaps[0] = H245_TERMCAPID_T120;
ulNumArrays ++;
}
g_TermCapDescriptor_LAN.CapDesc.Length = ulNumArrays;
// success
return TRUE;
}
///////////////////////////////////////////////////////////////////////////////
// //
// Public procedures //
// //
///////////////////////////////////////////////////////////////////////////////
BOOL
InitializeTermCaps(
)
/*++
Routine Description:
Initializes terminal capabilites list.
Arguments:
None.
Return Values:
Returns true if successful.
--*/
{
g_TermCapT120.Dir = H245_CAPDIR_LCLRXTX;
g_TermCapT120.DataType = H245_DATA_DATA;
g_TermCapT120.ClientType = H245_CLIENT_DAT_T120;
g_TermCapT120.CapId = H245_TERMCAPID_T120;
g_TermCapT120.Cap.H245Dat_T120.application.choice =
DACy_applctn_t120_chosen;
g_TermCapT120.Cap.H245Dat_T120.application.u.DACy_applctn_t120.choice =
separateLANStack_chosen;
g_TermCapT120.Cap.H245Dat_T120.maxBitRate = 0; // updated later.
// initialize g723 capabilities
g_TermCapG723.Dir = H245_CAPDIR_LCLRX;
g_TermCapG723.DataType = H245_DATA_AUDIO;
g_TermCapG723.ClientType = H245_CLIENT_AUD_G723;
g_TermCapG723.CapId = H245_TERMCAPID_G723;
g_TermCapG723.Cap.H245Aud_G723.silenceSuppression = FALSE;
g_TermCapG723.Cap.H245Aud_G723.maxAl_sduAudioFrames =
G723_FRAMES_PER_PACKET(
G723_MAXIMUM_MILLISECONDS_PER_PACKET
);
// initialize g711 capabilities
g_TermCapG711ULaw64.Dir = H245_CAPDIR_LCLRX;
g_TermCapG711ULaw64.DataType = H245_DATA_AUDIO;
g_TermCapG711ULaw64.ClientType = H245_CLIENT_AUD_G711_ULAW64;
g_TermCapG711ULaw64.CapId = H245_TERMCAPID_G711_ULAW64;
g_TermCapG711ULaw64.Cap.H245Aud_G711_ULAW64 =
G711_FRAMES_PER_PACKET(
G711_MAXIMUM_MILLISECONDS_PER_PACKET
);
// initialize g711 capabilities
g_TermCapG711ALaw64.Dir = H245_CAPDIR_LCLRX;
g_TermCapG711ALaw64.DataType = H245_DATA_AUDIO;
g_TermCapG711ALaw64.ClientType = H245_CLIENT_AUD_G711_ALAW64;
g_TermCapG711ALaw64.CapId = H245_TERMCAPID_G711_ALAW64;
g_TermCapG711ALaw64.Cap.H245Aud_G711_ALAW64 =
G711_FRAMES_PER_PACKET(
G711_MAXIMUM_MILLISECONDS_PER_PACKET
);
// initialize h261 capabilities
g_TermCapH261.Dir = H245_CAPDIR_LCLRX;
g_TermCapH261.DataType = H245_DATA_VIDEO;
g_TermCapH261.ClientType = H245_CLIENT_VID_H261;
g_TermCapH261.CapId = H245_TERMCAPID_H261;
g_TermCapH261.Cap.H245Vid_H261.bit_mask = H261VdCpblty_qcifMPI_present;
g_TermCapH261.Cap.H245Vid_H261.H261VdCpblty_qcifMPI = H261_QCIF_MPI;
g_TermCapH261.Cap.H245Vid_H261.maxBitRate = MAXIMUM_BITRATE_H26x_QCIF;
g_TermCapH261.Cap.H245Vid_H261.tmprlSptlTrdOffCpblty = FALSE;
g_TermCapH261.Cap.H245Vid_H261.stillImageTransmission = FALSE;
// initialize h263 capabilities
g_TermCapH263_LAN.Dir = H245_CAPDIR_LCLRX;
g_TermCapH263_LAN.DataType = H245_DATA_VIDEO;
g_TermCapH263_LAN.ClientType = H245_CLIENT_VID_H263;
g_TermCapH263_LAN.CapId = H245_TERMCAPID_H263;
g_TermCapH263_LAN.Cap.H245Vid_H263.bit_mask = H263VdCpblty_qcifMPI_present;
g_TermCapH263_LAN.Cap.H245Vid_H263.H263VdCpblty_qcifMPI = H263_QCIF_MPI;
g_TermCapH263_LAN.Cap.H245Vid_H263.unrestrictedVector = FALSE;
g_TermCapH263_LAN.Cap.H245Vid_H263.arithmeticCoding = FALSE;
g_TermCapH263_LAN.Cap.H245Vid_H263.advancedPrediction = FALSE;
g_TermCapH263_LAN.Cap.H245Vid_H263.pbFrames = FALSE;
g_TermCapH263_LAN.Cap.H245Vid_H263.tmprlSptlTrdOffCpblty = FALSE;
// make copies of termcaps
g_TermCapH263_28800 = g_TermCapH263_LAN;
g_TermCapH263_35000 = g_TermCapH263_LAN;
g_TermCapH263_42000 = g_TermCapH263_LAN;
g_TermCapH263_49000 = g_TermCapH263_LAN;
g_TermCapH263_56000 = g_TermCapH263_LAN;
g_TermCapH263_ISDN = g_TermCapH263_LAN;
// modify bitrate for speed of each link
g_TermCapH263_28800.Cap.H245Vid_H263.maxBitRate = MAXIMUM_BITRATE_28800;
g_TermCapH263_35000.Cap.H245Vid_H263.maxBitRate = MAXIMUM_BITRATE_35000;
g_TermCapH263_42000.Cap.H245Vid_H263.maxBitRate = MAXIMUM_BITRATE_42000;
g_TermCapH263_49000.Cap.H245Vid_H263.maxBitRate = MAXIMUM_BITRATE_49000;
g_TermCapH263_56000.Cap.H245Vid_H263.maxBitRate = MAXIMUM_BITRATE_56000;
g_TermCapH263_ISDN.Cap.H245Vid_H263.maxBitRate = MAXIMUM_BITRATE_ISDN;
g_TermCapH263_LAN.Cap.H245Vid_H263.maxBitRate = MAXIMUM_BITRATE_H26x_QCIF;
UpdateSimultaneousCapabilities();
// success
return TRUE;
}
BOOL
H323GetTermCapList(
PH323_CALL pCall,
PCC_TERMCAPLIST pTermCapList,
PCC_TERMCAPDESCRIPTORS pTermCapDescriptors
)
/*++
Routine Description:
Initializes terminal capabilities list.
Arguments:
None.
Return Values:
Returns true if successful.
--*/
{
H323DBG((
DEBUG_LEVEL_TRACE,
"H323GetTermCapList, g_fAdvertiseT120:%d\n",
g_fAdvertiseT120
));
if (pCall->dwLinkSpeed < (MAXIMUM_BITRATE_28800 * 100)) {
// determine number of elements and save pointer to array
pTermCapList->wLength = SIZEOF_TERMCAPLIST(g_TermCapArray_14400);
pTermCapList->pTermCapArray = g_TermCapArray_14400;
// determine number of elements and save pointer to array
pTermCapDescriptors->wLength = 1;
pTermCapDescriptors->pTermCapDescriptorArray = g_TermCapDArray_14400;
} else if (pCall->dwLinkSpeed < (MAXIMUM_BITRATE_35000 * 100)) {
// determine number of elements and save pointer to array
pTermCapList->wLength = SIZEOF_TERMCAPLIST(g_TermCapArray_28800);
pTermCapList->pTermCapArray = g_TermCapArray_28800;
// do not publish the T120 cap at the end of the array.
if (!g_fAdvertiseT120) pTermCapList->wLength --;
// determine number of elements and save pointer to array
pTermCapDescriptors->wLength = 1;
pTermCapDescriptors->pTermCapDescriptorArray = g_TermCapDArray_28800;
} else if (pCall->dwLinkSpeed < (MAXIMUM_BITRATE_42000 * 100)) {
// determine number of elements and save pointer to array
pTermCapList->wLength = SIZEOF_TERMCAPLIST(g_TermCapArray_35000);
pTermCapList->pTermCapArray = g_TermCapArray_35000;
// do not publish the T120 cap at the end of the array.
if (!g_fAdvertiseT120) pTermCapList->wLength --;
// determine number of elements and save pointer to array
pTermCapDescriptors->wLength = 1;
pTermCapDescriptors->pTermCapDescriptorArray = g_TermCapDArray_35000;
} else if (pCall->dwLinkSpeed < (MAXIMUM_BITRATE_49000 * 100)) {
// determine number of elements and save pointer to array
pTermCapList->wLength = SIZEOF_TERMCAPLIST(g_TermCapArray_42000);
pTermCapList->pTermCapArray = g_TermCapArray_42000;
// do not publish the T120 cap at the end of the array.
if (!g_fAdvertiseT120) pTermCapList->wLength --;
// determine number of elements and save pointer to array
pTermCapDescriptors->wLength = 1;
pTermCapDescriptors->pTermCapDescriptorArray = g_TermCapDArray_42000;
} else if (pCall->dwLinkSpeed < (MAXIMUM_BITRATE_56000 * 100)) {
// determine number of elements and save pointer to array
pTermCapList->wLength = SIZEOF_TERMCAPLIST(g_TermCapArray_49000);
pTermCapList->pTermCapArray = g_TermCapArray_49000;
// do not publish the T120 cap at the end of the array.
if (!g_fAdvertiseT120) pTermCapList->wLength --;
// determine number of elements and save pointer to array
pTermCapDescriptors->wLength = 1;
pTermCapDescriptors->pTermCapDescriptorArray = g_TermCapDArray_49000;
} else if (pCall->dwLinkSpeed < (MAXIMUM_BITRATE_63000 * 100)) {
// determine number of elements and save pointer to array
pTermCapList->wLength = SIZEOF_TERMCAPLIST(g_TermCapArray_56000);
pTermCapList->pTermCapArray = g_TermCapArray_56000;
// do not publish the T120 cap at the end of the array.
if (!g_fAdvertiseT120) pTermCapList->wLength --;
// determine number of elements and save pointer to array
pTermCapDescriptors->wLength = 1;
pTermCapDescriptors->pTermCapDescriptorArray = g_TermCapDArray_56000;
} else if (pCall->dwLinkSpeed < (MAXIMUM_BITRATE_ISDN * 100)) {
// determine number of elements and save pointer to array
pTermCapList->wLength = SIZEOF_TERMCAPLIST(g_TermCapArray_ISDN);
pTermCapList->pTermCapArray = g_TermCapArray_ISDN;
// do not publish the T120 cap at the end of the array.
if (!g_fAdvertiseT120) pTermCapList->wLength --;
// determine number of elements and save pointer to array
pTermCapDescriptors->wLength = 1;
pTermCapDescriptors->pTermCapDescriptorArray = g_TermCapDArray_ISDN;
} else {
// determine number of elements and save pointer to array
pTermCapList->wLength = SIZEOF_TERMCAPLIST(g_TermCapArray_LAN);
pTermCapList->pTermCapArray = g_TermCapArray_LAN;
// do not publish the T120 cap at the end of the array.
if (!g_fAdvertiseT120) pTermCapList->wLength --;
// determine number of elements and save pointer to array
pTermCapDescriptors->wLength = 1;
pTermCapDescriptors->pTermCapDescriptorArray = g_TermCapDArray_LAN;
}
// This is a hack to put the right T120 bitrate into the PDU.
g_TermCapT120.Cap.H245Dat_T120.maxBitRate = pCall->dwLinkSpeed;
// success
return TRUE;
}
BOOL
H323ProcessConfigT120Command(
PH323MSG_CONFIG_T120_COMMAND pCommand
)
{
H323DBG((
DEBUG_LEVEL_TRACE,
"H323ProcessConfigT120Command. IP:%x, port:%d\n",
pCommand->dwIP, pCommand->wPort
));
// update the T120 information.
g_fAdvertiseT120 = pCommand->fEnable;
g_dwIPT120 = pCommand->dwIP;
g_wPortT120 = pCommand->wPort;
UpdateSimultaneousCapabilities();
return TRUE;
}
BOOL
H323ProcessConfigCapabilityCommand(
PH323MSG_CONFIG_CAPABILITY_COMMAND pCommand
)
{
DWORD dw;
ASSERT(pCommand->dwNumCaps <= MAX_CAPS);
// update the weight table
for (dw = 0; dw < pCommand->dwNumCaps; dw ++)
{
H245_CAPABILITY cap = pCommand->pCapabilities[dw];
g_CapabilityWeights[cap] = pCommand->pdwWeights[dw];
}
UpdateSimultaneousCapabilities();
return TRUE;
}