In This Topic ▼

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 IltmmRTSPServer to implement an 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