In This Topic ▼

IltmmRTSPServer::StartServer

Summary

Starts the RTSP server listening on the specified port.

Syntax

#include "ltmm.h"

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

Parameters

IltmmRTSPServer *pThis

Pointer to the IltmmRTSPServer interface.

long port

The port on which to listen for incoming connections. The standard port address for RTSP servers is ltmmRTSP_DefaultPort (554).

Returns

Value	Meaning
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).