IWMSPublishingPointPeakCounters::get_StreamingUDPPlayers

The get_StreamingUDPPlayers method retrieves the maximum number of players that have streamed content simultaneously by using the User Datagram Protocol (UDP) from the publishing point.

HRESULT get_StreamingUDPPlayers(
  long*  pVal
);

Arguments

pVal

[out] Pointer to a long containing the maximum number of players that have streamed content.

Return Value

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code

Number

Description

E_POINTER

0x80004003

Indicates that pVal is a NULL pointer argument.

Remarks

Clients that have stopped or paused rendering the stream are not included in the count.

You can reset the pVal parameter to the current value by calling the IWMSPublishingPointPeakCounters::Reset method.

Example

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

// Declare variables and interfaces.
IWMSServer                      *pServer;
IWMSPublishingPoints            *pPubPoints;
IWMSPublishingPoint             *pPubPoint;
IWMSPublishingPointPeakCounters *pPeakCounters;

HRESULT         hr;
DATE            dtTime;
CComVariant     varIndex;
long            lCount;
long            lValue;

// 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 the IWMSPublishingPoints interface
// and retrieve the total count of publishing points.
hr = pServer->get_PublishingPoints(&pPubPoints);
if (FAILED(hr)) goto EXIT;
hr = pPubPoints->get_Count(&lCount);
if (FAILED(hr)) goto EXIT;

// Retrieve information about each publishing point.
for (long x = 0; x < lCount; x++)
{
    varIndex = x;
    hr = pPubPoints->get_Item(varIndex, &pPubPoint);
    if (FAILED(hr)) goto EXIT;

    // Retrieve a pointer to a list of peak statistics
    // for the publishing point.
    hr = pPubPoint->get_PeakCounters(&pPeakCounters);
    if (FAILED(hr)) goto EXIT;

    // Retrieve the maximum number of streaming players
    // since the start time.
    hr = pPeakCounters->get_StreamingUDPPlayers(&lValue);
    if (FAILED(hr)) goto EXIT;

    // Release temporary COM objects.
    pPubPoint->Release();
    pPeakCounters->Release();
}

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

Requirements

Header: wmsserver.h.

Library: WMSServerTypeLib.dll.

Platform: Windows ServerĀ 2008 family.

See Also

Reference

IWMSPublishingPointPeakCounters Interface