Collapse All Expand All

IltmmRTSPServer::StartServer

#include "ltmm.h"

C Syntax	HRESULT IltmmRTSPServer_StartServer(pThis, port)
C++ Syntax	HRESULT StartServer(port)

 

IltmmRTSPServer *pThis;	/* pointer to the interface */
long port;	/* port on which to listen */

Starts the RTSP server listening on the specified port.

Parameter	Description
pThis	Pointer to the IltmmRTSPServer interface.
port	The port on which to listen for incoming connections. The standard port address for RTSP servers is ltmmRTSP_DefaultPort (554).

Returns

S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

This function turns the server live and make it ready to begin listening for connections on the port indicated by the port parameter. The IP address on which it will listen should have been specified prior to calling this function using IltmmRTSPServer::put_TargetAddress.

The server will run until you stop it with IltmmRTSPServer::StopServer.

The source folders and all the other server setting should have been set prior to calling this function. See the IltmmRTSPServer interface and Use IltmmRTPServer to implement a RTSP Server topics for more information on the RTSP server settings.

The port should be available and not in use by another program (such as the Windows Media Player Network Sharing Service). Port values can be between 1 and 65535. If you choose a port number other than 554 it is recommended to use a port value above 1024. Doing so avoids conflicts with other programs that might be running on your server (many port values below 1024 are restricted for system use or for well-defined protocols such as 80 for HTTP and 554 for RTSP).

Required DLLs and Libraries

LTMM For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Elements:	IltmmRTSPServer interface , IltmmRTSPServer::StopServer, IltmmRTSPServer::put_SourceFolder, IltmmRTSPServer::put_TargetAddress, IltmmRTSPServer::put_Security, IltmmRTSPServer::put_LiveLatency, IltmmRTSPServer::LoadSettingsFromFile, IltmmRTSPServer::LoadSettingsFromStream
Topics:	Multimedia Function Groups Use IltmmRTPServer to implement an RTSP Server Sarting a server on the default RTSP port fails when running the Windows 8 RTSPServer demo

Example

For a C++ example, refer to IltmmRTSPServer Example for C++.