104 lines
3.9 KiB
Plaintext
104 lines
3.9 KiB
Plaintext
--------------------------------------------------------------------------
|
|
|
|
Copyright (C) 1998-2003 Microsoft Corporation. All rights reserved.
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
TAPI 3.1 Pluggable Terminals Sample Application
|
|
|
|
|
|
Overview:
|
|
~~~~~~~~~
|
|
|
|
PlgTerm is a sample TAPI 3.1 application that shows how to create a pluggable
|
|
terminal. It uses MSPBase classes and DirectShow\BaseClasses.
|
|
|
|
PLUGGABLE.CPP shows how to register the terminal for TerminalManger and
|
|
and how to register the COM component.
|
|
|
|
PLGTERM.CPP shows the implementation of the virtual or pure vitual methods
|
|
which a terminal must or may implement.
|
|
|
|
PLGTERMFILTER.CPP shows the implementation of the terminal filter.
|
|
PLGTERMPIN.CPP shows the implementation of the pin on the terminal filter.
|
|
|
|
The terminal is a render terminal and it would print the size of the received
|
|
sample after the terminal was selected on an active stream.
|
|
|
|
It need TAPI3.1 and will run only under Windows XP.
|
|
|
|
How to build the sample:
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Set the SDK build environment
|
|
|
|
Before building the PLGTERM sample application you need to
|
|
-install the DirectX9 SDK
|
|
-build the $(MSSDK)\samples\Multimedia\DirectShow\BaseClasses sample
|
|
to produce UNICODE strmbase.lib or UNICODE strmbasd.lib file before building PlgTerm sample
|
|
-Set the build configuration of the BaseClasses sample to "Debug Unicode" or "Release Unicode"
|
|
using Visual Studio's build configuration manager to build UNICODE libraries
|
|
-run the setenv.bat file in the Platform SDK root dir
|
|
|
|
-build $(MSSDK)\Samples\NetDS\Tapi\Tapi3\Cpp\Msp\MSPBase sample to produce MSPBaseSample.lib
|
|
Type nmake in the MSPBase directory
|
|
|
|
If all the necessary are built correctly you may build the PLGTERM sample application.
|
|
Type "nmake" in the PLGTERM directory. This will build plgterm.dll.
|
|
This sample uses DirectShow\BaseClasses so you need to have Multimedia samples
|
|
installed in order to build this sample.
|
|
|
|
|
|
How to use the sample:
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
After the sample is built, you'll need to register the terminal
|
|
"regsvr32 plgterm.dll" in order to use it.
|
|
|
|
After create a TAPI3 call you can select the terminal on a render audio stream.
|
|
After call is connected and the streams is active it will log the samples size
|
|
|
|
What functionality does this sample show:
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The incoming sample application demonstrates how to use pluggable terminals
|
|
mechanism and how to build a terminal using MSPBase classes
|
|
|
|
What this sample does not show:
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
This sample does not show how the received samples are used.
|
|
|
|
Hints:
|
|
~~~~~~
|
|
|
|
If you do not want this terminal to show up in the list of TAPI3.1 terminals
|
|
you need to deregister it - "regsvr32 /u plgterm.dll"
|
|
|
|
Additional Notes on how to build the sample:
|
|
|
|
How to build the samples with VS.Net or VC6 or VC5:
|
|
- install DirectX9 SDK
|
|
- build the $(MSSDK)\samples\Multimedia\DirectShow\BaseClasses
|
|
DirectShow sample. Build UNICODE (debug or release or both) configurations
|
|
using the Visual studio Envoriment
|
|
- go to the path where you installed the platform SDK
|
|
(e.g. C:\Program Files\Microsoft SDK)
|
|
and type SetEnv.Bat.
|
|
- check the following environment variables:
|
|
PATH, LIB, INCLUDE. You can see their current
|
|
values by typing "SET" at the command prompt.
|
|
You should see that they contain first the SDK
|
|
paths and then the VC6 paths.
|
|
- Set the enviroment variable DXSDK_DIR to point to the
|
|
root directory of the DirectX9 SDK
|
|
(e.g. set DXSDK_DIR=C:\DXSDK )
|
|
NOTE: With latest Direct X SDK(DirectX 9.0 SDK -August 2005) , DXSDK_DIR is already set
|
|
set it manually only if the env var is not already set
|
|
|
|
You can add this to the setenv.bat so DXSDK_DIR will be set
|
|
whenever you run setenv.bat. A good place to add this
|
|
line is right after the set MSSDK= line
|
|
- go to the path where the PlgTerm sample is installed
|
|
(Samples\NetDS\Tapi\Tapi3\cpp\Pluggable) and type NMAKE.
|