IltmmRTSPServer::get_SourceFolder

#include "ltmm.h"

C Syntax	HRESULT IltmmRTSPServer_get_SourceFolder(This, index, pValue)
C++ Syntax	HRESULT get_SourceFolder(index, pValue)

IltmmFilterEnum *This;	pointer to the interface instance
long index;	index of the folder name to retrieve
BSTR *pValue;	pointer to a variable

Retrieves one of the folders from the source folder list.

Parameter	Description
This	Pointer to the IltmmRTSPServer Interface.
index	0-based index of the source folder that should be retrieved. The source folders are stored as an array of folder names.
pValue	Pointer to a variable to be updated with the folder name. The folder names are absolute and should be fully specified.

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

The RTSP Server keeps an internal list of folders which store the source files for the server. When a client asks for a file to stream, the RTSP Server will look for the requested file in this source folder list, in order.

So the server looks in the first folder first. If it doesn't find it, it looks in the next folder and so on until it finds a filter containing the requested file.

This function can be used to enumerate the source folders that have been added so far to the RTSP Server using IltmmRTSPServer::put_SourceFolder.

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