IWMSDirectory Object (C#)

You can implement the IWMSDirectory object to navigate a directory. For example, consider the following playlist in which *.wmv indicates that all of the Windows Media files in the c:\wmpub\wmroot directory are to be streamed to the client.

<?wsx version="1.0"?>
<smil>
    <media src = "c:\wmpub\wmroot\*.wmv"/>
</smil>

Because the media element uses the wildcard character "*" to identify all of the Windows Media files in the directory, the server calls IWMSDataSourcePlugin.OpenDirectory on a file system data source plug-in. The plug-in creates an instance of an object that implements the IWMSDirectory object, enumerates the media files in the directory, and passes the server a pointer to the IWMSDirectory object when it calls IWMSDataSourcePluginCallback.OnOpenDirectory. The server then calls IWMSPlaylistParser.ReadPlaylistFromDirectory on an enabled playlist parser plug-in and passes in the IWMSDirectory object. The playlist parser plug-in uses the object to call GetChildInfo and retrieve information about the files in the directory.

Note

The file system data source plug-in must support enumeration. Also, This object is available only on Windows Server 2003, Enterprise Edition; Windows Server 2003, Datacenter Edition; and Windows Server 2008.

The IWMSDirectory object exposes the following properties and methods.

Method

Description

GetChildInfo

Retrieves information about a specific media element in a directory.

GetDataSourcePlugin

Retrieves a reference to the plug-in used to source content from the directory.

GetName

Retrieves the full path of the directory, including the URL scheme.

See Also

Concepts

Custom Plug-in Objects (C#)