Clientprotokollierung (Microsoft Media Foundation)

Die Netzwerkquelle unterstützt die Clientprotokollierung, die dem Medienserver eine Möglichkeit bietet, die Aktivität der Clients nachzuverfolgen, die eine Verbindung mit ihr herstellen. Clientprotokolle ermöglichen es einem Server, Verbindungs-, Rendering- und Streamingstatistiken aufzuzeichnen. Diese Protokolle können von Inhaltsanbietern in verschiedenen Szenarien verwendet werden, z. B. zum Nachverfolgen der Medienservernutzung und zum Generieren von Abrechnungen oder zum Bereitstellen von Inhalten in geeigneter Qualität, abhängig von der Geschwindigkeit des Netzwerks des Clients.

Eine Protokolldatei enthält mehrere Clientereigniseinträge. Jeder Protokolleintrag enthält eine Reihe leergetrennter Felder. Es gibt zwei Arten von Clientprotokollen: Rendering (Wiedergabe) und Streaming (Empfangen). Da Inhalte gleichzeitig wiedergegeben und gestreamt werden können, kann der Client eine Kombination aus beiden Protokolldatentypen senden. In bestimmten Fällen können zwei Protokolleinträge für dieselbe Sitzung vorhanden sein. Wenn z. B. Fast Cache aktiviert ist, kann der Client den Empfang des gestreamten Inhalts abschließen, bevor er das Rendern abgeschlossen hat. In diesem Fall würden die Streamingprotokolldaten vor den Renderingprotokolldaten gesendet.

Der Client sendet Renderingprotokolldaten an den Server, wenn der Client von einem beliebigen Wiedergabezustand (Wiedergabe, Fast-Forward oder Zurückspulen) in einen nicht wiedergegebenen Zustand wechselt (Beenden, Anhalten, Ende des Datenstroms und Beginn des Datenstroms). Wenn Daten für ein Renderingprotokoll übermittelt werden, wird direkt eine Verbindung mit dem Medienserver oder einem konfigurierten Proxyserver hergestellt.

Wenn der Inhalt in einer temporären lokalen Cachedatei auf dem Computer gespeichert ist, auf dem der Client ausgeführt wird, kann der Client eine Datei aus dem lokalen Cache lesen und die Renderingprotokolldaten übermitteln, um anzugeben, dass er den Inhalt wiedergegeben hat. In diesem Fall liest der Client eine Datei aus dem lokalen Cache, der Renderingprotokolleintrag enthält keine Netzwerkstatistiken, und das Protokoll ist auf Cache festgelegt.

Der Client sendet Streamingprotokolldaten an den Server, um anzugeben, wie der Client den Inhalt empfangen hat, aber nicht, wie er gerendert wurde. Der Client kann das Streamingprotokoll senden, lange bevor der Client das Rendern des Inhalts abgeschlossen hat.

Dieses Thema enthält keine Informationen zu allen Protokollfeldern. Eine vollständige Referenz finden Sie unter Windows Media-Protokolldatenstruktur.

Konfigurieren von Protokollfeldern

Media Foundation ermöglicht es dem Client, die Netzwerkquelle mithilfe von Eigenschaften zu konfigurieren. Die Anwendung muss die entsprechenden Eigenschaften in einem Eigenschaftenspeicher festlegen und an eine der Quelllösermethoden übergeben. Der Quelllöser erstellt die Netzwerkquelle wie angefordert und öffnet eine Verbindung mit dem Server. Wenn die Verbindung erfolgreich ist, sendet der Client Informationen über sich selbst.

In der folgenden Tabelle werden die Protokollfelder und die entsprechenden Eigenschaften beschrieben, die eine Anwendung über den Quelllöser festlegen kann. Diese Informationen ändern sich während der Sitzung nicht.

Das folgende Codebeispiel zeigt, wie eine Clientanwendung die Netzwerkquelle konfiguriert. In diesem Beispiel wird das Protokollfeld "c-hostexe" festgelegt.

// Creates a media source from a URL.
//
// This example demonstrates how to set the MFNETSOURCE_HOSTEXE
// configuration property on the network source.

HRESULT CreateMediaSourceWithLogParams(
    PCWSTR pszURL, 
    IMFMediaSource **ppSource
    )
{
    IPropertyStore *pConfig = NULL;

    // Configure the property store.
    HRESULT hr = PSCreateMemoryPropertyStore(IID_PPV_ARGS(&pConfig));

    if (SUCCEEDED(hr))
    {
        PROPERTYKEY key;
        key.fmtid =  MFNETSOURCE_HOSTEXE;
        key.pid = 0;

        PROPVARIANT var;
        var.vt = VT_LPWSTR;
        var.pwszVal = L"MyPlayer.exe";

        hr = pConfig->SetValue(key, var);
    }

    // Create the source media source.
    if (SUCCEEDED(hr))
    {
        hr = CreateMediaSource(pszURL, pConfig, ppSource);
    }

    SafeRelease(&pConfig);
    return hr;
}

Abrufen von Netzwerkstatistiken

Wenn die Anwendung eine der Quelllösermethoden aufruft, erstellt sie die Netzwerkquelle, legt die im Eigenschaftenspeicher angegebenen Eigenschaften fest und öffnet eine Sitzung mit dem Medienserver. Zusätzlich zu den konfigurierbaren Informationen, die im vorherigen Abschnitt beschrieben wurden, werden zu Beginn der Sitzung, während des Streamings und beim Schließen der Sitzung zusätzliche Daten zwischen dem Server und dem Client übertragen.

Die Anwendung kann Netzwerkstatistiken mithilfe des MFNETSOURCE_STATISTICS_SERVICE Dienstbezeichners abrufen. Um diesen Dienst zu verwenden, kann die Anwendung die MFGetService-Funktion aufrufen, um den Eigenschaftenspeicher abzurufen, der Netzwerkstatistiken in der MFNETSOURCE_STATISTICS-Eigenschaft enthält. Bestimmte Werte können abgerufen werden, indem Sie den entsprechenden Bezeichner angeben, der in der MFNETSOURCE_STATISTICS_IDS-Enumeration definiert ist.

Das folgende Codebeispiel zeigt, wie Sie den Dienst verwenden, um die Anzahl der vom Client empfangenen Pakete abzurufen.

HRESULT GetPacketsReceived(IMFMediaSession *pSession, DWORD *pcPackets)
{
    IPropertyStore *pProp = NULL;
    PROPVARIANT var;

    // Get the property store from the media session.
    HRESULT hr = MFGetService(
        pSession, 
        MFNETSOURCE_STATISTICS_SERVICE, 
        IID_PPV_ARGS(&pProp)
        );

    // Get the number of packets received by the client.

    if (SUCCEEDED(hr))
    {
        PROPERTYKEY key;
        key.fmtid = MFNETSOURCE_STATISTICS;
        key.pid = MFNETSOURCE_RECVPACKETS_ID;

        hr = pProp->GetValue(key, &var);
    }

    if (SUCCEEDED(hr))
    {
        *pcPackets = var.lVal;
    }

    PropVariantClear(&var);
    SafeRelease(&pProp);
    return hr;
}

In der folgenden Liste werden einige der Netzwerkstatistikbezeichner beschrieben, die in MFNETSOURCE_STATISTICS_IDS definiert sind.

Zugehörige Themen

Netzwerkquellenfeatures

Netzwerk in Media Foundation