IWMSPlaylist Interface

  • Article

banner art

Previous Next

IWMSPlaylist Interface

You can use the IWMSPlaylist interface to manage a playlist.

In addition to the methods inherited from IXMLDOMDocument, the IWMSPlaylist interface exposes the following methods.

Method Description
CueStream Prepares the next stream in the queue.
FireEvent Sends the specified event to the playlist.
get_CallerEntry Retrieves the current caller entry.
get_CurrentMediaInformation Retrieves an IWMSActiveMedia interface containing information about the active media element in the playlist.
get_CurrentPlaylistEntry Retrieves the active playlist element.
get_ElapsedSimpleTime Retrieves the simple duration of the active playlist element.
get_IsStreamCued Retrieves a Boolean value indicating whether a specific playlist element has been initialized and is ready to stream.
get_NestedPlaylist Retrieves a nested playlist object.
put_CurrentPlaylistEntry Specifies the active playlist element.
UncueStream Specifies that content previously prepared for streaming is uncued.

Example Code

The following example illustrates how to retrieve a pointer to an IWMSPlaylist interface.

#include <windows.h>
#include <atlbase.h>    // Includes CComVariant.
#include "wmsserver.h"

// Declare variables and interfaces.
IWMSServer      *pServer;
IWMSPlayers     *pPlayers;
IWMSPlayer      *pPlayer;
IWMSPlaylist    *pPlaylist;

HRESULT         hr;
CComVariant     varIndex;
long            lCount;

// Initialize the COM library and retrieve a pointer
// to an IWMSServer interface.
hr = CoInitialize(NULL);
hr = CoCreateInstance(CLSID_WMSServer,
                      NULL,
                      CLSCTX_ALL,
                      IID_IWMSServer,
                      (void **)&pServer);
if (FAILED(hr)) goto EXIT;

// Retrieve a pointer to an IWMSPlayers interface
// and retrieve the total count of current connections.
hr = pServer->get_Players(&pPlayers);
if (FAILED(hr)) goto EXIT;
hr = pPlayers->get_Count(&lCount);
if (FAILED(hr)) goto EXIT;

// Retrieve information about each requested playlist.
for (long x = 0; x < lCount; x++)
{
    varIndex = x;
    hr = pPlayers->get_Item(varIndex, &pPlayer);
    if (FAILED(hr)) goto EXIT;

    // Retrieve the playlist requested by the client
    // if one exists.
    hr = pPlayer->get_RequestedPlaylist(&pPlaylist);
    if (FAILED(hr)) goto EXIT;

    // Release temporary COM objects.
    pPlayer->Release();
    pPlaylist->Release();
}

EXIT:
    // TODO: Release temporary COM objects and uninitialize COM.

See Also

Previous Next