用戶端記錄 （Microsoft Media Foundation）

網路來源支援客戶端記錄，這為媒體伺服器追蹤與其連線之客戶端的活動提供了一種方式。 用戶端記錄可讓伺服器記錄連線、轉譯和串流統計數據。 這些記錄可供內容提供者在各種案例中使用，例如追蹤媒體伺服器使用量併產生計費，或根據客戶端網路的速度提供適當的質量內容。

記錄檔包含數個用戶端事件項目。 每個日誌條目都包含一些以空格分隔的欄位。 客戶端記錄有兩種類型：轉譯（播放）和 串流（接收）。 因為內容可以同時播放和串流，用戶端可以傳送這兩種類型的記錄數據的組合。 在某些情況下，同一個會話可能會有兩個日誌條目存在。 例如，啟用快速快取時，用戶端可以在完成轉譯之前完成接收串流內容。 在此情況下，串流記錄數據會在轉譯記錄數據之前傳送。

當用戶端從任何播放狀態（播放、快速轉送或倒轉）變更為非播放狀態時，用戶端會將轉譯記錄數據傳送至伺服器（停止、暫停、數據流結束和數據流開頭）。 提交轉譯記錄檔的數據時，會直接連線到媒體伺服器或已設定的 Proxy 伺服器。

如果內容儲存在執行客戶端的計算機上暫存本機快取檔案中，用戶端可以從其本機快取讀取檔案，並提交轉譯記錄數據，以指出它已播放內容。 在此情況下，客戶端會從本機快取讀取檔案；渲染日誌條目不包含任何網路統計數據，且通訊協定設定為快取。

用戶端會將串流記錄數據傳送至伺服器，以指出用戶端如何接收內容，但無法指出其轉譯方式。 用戶端可以在用戶端完成轉譯內容之前，傳送串流記錄。

本主題不提供所有記錄欄位的相關信息。 如需完整參考，請參閱 Windows 媒體記錄資料結構。

設定記錄欄位

Media Foundation 可讓用戶端使用屬性來設定網路來源。 應用程式必須在屬性存放區中設定適當的屬性，並將它傳遞至其中一個來源解析程式方法。 來源解析程式會依照要求建立網路來源，並開啟與伺服器的連線。 如果連線成功，用戶端會傳送本身的相關信息。

下表描述應用程式可透過來源解析程式設定的記錄欄位和對應的屬性。 這項資訊不會在會話期間變更。

下列程式代碼範例示範用戶端應用程式如何設定網路來源。 本範例會設定 「c-hostexe」 記錄欄位。

// 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;
}

擷取網路統計數據

當應用程式呼叫其中一個來源解析程式方法時，它會建立網路來源、設定屬性存放區中指定的屬性，以及開啟與媒體伺服器的會話。 除了上一節所述的可設定資訊之外，在會話開始時、串流期間以及會話關閉期間，伺服器與客戶端之間會傳輸其他數據。

應用程式可以使用 MFNETSOURCE_STATISTICS_SERVICE 服務標識符來擷取網路統計數據。 若要使用此服務，應用程式可以呼叫 MFGetService 函式，以取得屬性存放區，其中包含 MFNETSOURCE_STATISTICS 屬性中的網路統計數據。 藉由提供 MFNETSOURCE_STATISTICS_IDS 列舉中定義的對應標識符，即可擷取特定值。

下列程式代碼範例示範如何使用服務來取得用戶端所接收的封包數目。

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;
}

下列清單描述 MFNETSOURCE_STATISTICS_IDS中定義的一些網路統計數據識別碼。

相關主題

網路來源功能

媒體基礎中的網路