步驟 5：處理媒體會話事件

本主題是 如何使用 Media Foundation 播放媒體檔案教學課程的步驟 5。 完整的程式碼會顯示在 媒體會話播放範例主題中。

如需本主題的背景，請參閱 媒體事件產生器。 本主題包含下列幾節：

• 取得會話事件
• MESessionTopologyStatus
• MEEndOfPresentation
• MENewPresentation
• 相關主題

取得會話事件

若要從媒體會話取得事件，CPlayer 物件會呼叫 IMFMediaEventGenerator：：BeginGetEvent 方法，如 步驟 4：建立媒體會話所示。 這個方法是非同步，這表示它會立即傳回給呼叫端。 發生下一個會話事件時，媒體會話會呼叫 CPlayer 物件的 IMFAsyncCallback：：Invoke 方法。

請務必記住 ，叫 用會從背景工作執行緒呼叫，而不是從應用程式執行緒呼叫。 因此， Invoke 的實作必須是多執行緒安全。 其中一種方法是使用重要區段來保護成員資料。 不過，類別 CPlayer 會顯示替代方法：

1. 在 Invoke 方法中，CPlayer 物件會將 WM_APP_PLAYER_EVENT 訊息張貼至應用程式。 訊息參數是 IMFMediaEvent 指標。
2. 應用程式會收到 WM_APP_PLAYER_EVENT 訊息。
3. 應用程式會呼叫 CPlayer::HandleEvent 方法，傳入 IMFMediaEvent 指標。
4. 方法 HandleEvent 會回應 事件。

下列程式碼顯示 Invoke 方法：

//  Callback for the asynchronous BeginGetEvent method.

HRESULT CPlayer::Invoke(IMFAsyncResult *pResult)
{
    MediaEventType meType = MEUnknown;  // Event type

    IMFMediaEvent *pEvent = NULL;

    // Get the event from the event queue.
    HRESULT hr = m_pSession->EndGetEvent(pResult, &pEvent);
    if (FAILED(hr))
    {
        goto done;
    }

    // Get the event type. 
    hr = pEvent->GetType(&meType);
    if (FAILED(hr))
    {
        goto done;
    }

    if (meType == MESessionClosed)
    {
        // The session was closed. 
        // The application is waiting on the m_hCloseEvent event handle. 
        SetEvent(m_hCloseEvent);
    }
    else
    {
        // For all other events, get the next event in the queue.
        hr = m_pSession->BeginGetEvent(this, NULL);
        if (FAILED(hr))
        {
            goto done;
        }
    }

    // Check the application state. 
        
    // If a call to IMFMediaSession::Close is pending, it means the 
    // application is waiting on the m_hCloseEvent event and
    // the application's message loop is blocked. 

    // Otherwise, post a private window message to the application. 

    if (m_state != Closing)
    {
        // Leave a reference count on the event.
        pEvent->AddRef();

        PostMessage(m_hwndEvent, WM_APP_PLAYER_EVENT, 
            (WPARAM)pEvent, (LPARAM)meType);
    }

done:
    SafeRelease(&pEvent);
    return S_OK;
}

Invoke方法會執行下列步驟：

1. 呼叫 IMFMediaEventGenerator：：EndGetEvent 以取得事件。 這個方法會傳回 IMFMediaEvent 介面的指標。
2. 呼叫 IMFMediaEvent：：GetType 以取得事件程式碼。
3. 如果事件程式碼是 MESessionClosed，請呼叫 SetEvent 來設定 m_hCloseEvent 事件。 此步驟的原因會在 步驟 7：關閉媒體會話以及程式碼批註中說明。
4. 針對所有其他事件代碼，呼叫 IMFMediaEventGenerator：：BeginGetEvent 以要求下一個事件。
5. 將 WM_APP_PLAYER_EVENT 訊息張貼至視窗。

下列程式碼顯示 HandleEvent 方法，此方法會在應用程式收到 WM_APP_PLAYER_EVENT 訊息時呼叫：

HRESULT CPlayer::HandleEvent(UINT_PTR pEventPtr)
{
    HRESULT hrStatus = S_OK;            
    MediaEventType meType = MEUnknown;  

    IMFMediaEvent *pEvent = (IMFMediaEvent*)pEventPtr;

    if (pEvent == NULL)
    {
        return E_POINTER;
    }

    // Get the event type.
    HRESULT hr = pEvent->GetType(&meType);
    if (FAILED(hr))
    {
        goto done;
    }

    // Get the event status. If the operation that triggered the event 
    // did not succeed, the status is a failure code.
    hr = pEvent->GetStatus(&hrStatus);

    // Check if the async operation succeeded.
    if (SUCCEEDED(hr) && FAILED(hrStatus)) 
    {
        hr = hrStatus;
    }
    if (FAILED(hr))
    {
        goto done;
    }

    switch(meType)
    {
    case MESessionTopologyStatus:
        hr = OnTopologyStatus(pEvent);
        break;

    case MEEndOfPresentation:
        hr = OnPresentationEnded(pEvent);
        break;

    case MENewPresentation:
        hr = OnNewPresentation(pEvent);
        break;

    default:
        hr = OnSessionEvent(pEvent, meType);
        break;
    }

done:
    SafeRelease(&pEvent);
    return hr;
}

這個方法會呼叫 IMFMediaEvent：：GetType 來取得事件種類和 IMFMediaEvent：：GetStatus ，以取得與事件相關聯的失敗碼成功。 下一個採取的動作取決於事件程式碼。

MESessionTopologyStatus

MESessionTopologyStatus事件會發出拓撲狀態變更的訊號。 事件物件的 MF_EVENT_TOPOLOGY_STATUS 屬性包含狀態。 在此範例中，感興趣的唯一值 是MF_TOPOSTATUS_READY，這表示播放已準備好開始。

HRESULT CPlayer::OnTopologyStatus(IMFMediaEvent *pEvent)
{
    UINT32 status; 

    HRESULT hr = pEvent->GetUINT32(MF_EVENT_TOPOLOGY_STATUS, &status);
    if (SUCCEEDED(hr) && (status == MF_TOPOSTATUS_READY))
    {
        SafeRelease(&m_pVideoDisplay);

        // Get the IMFVideoDisplayControl interface from EVR. This call is
        // expected to fail if the media file does not have a video stream.

        (void)MFGetService(m_pSession, MR_VIDEO_RENDER_SERVICE, 
            IID_PPV_ARGS(&m_pVideoDisplay));

        hr = StartPlayback();
    }
    return hr;
}

方法 CPlayer::StartPlayback 會顯示在 步驟 6：控制項播放中。

此範例也會呼叫MFGetService，從增強式視訊轉譯器 (EVR) 取得IMFVideoDisplayControl介面。 需要此介面來處理重繪和調整視訊視窗的大小，也會顯示在 步驟 6：控制項播放中。

MEEndOfPresentation

MEEndOfPresentation事件表示播放已到達檔案結尾。 媒體會話會自動切換回停止狀態。

//  Handler for MEEndOfPresentation event.
HRESULT CPlayer::OnPresentationEnded(IMFMediaEvent *pEvent)
{
    // The session puts itself into the stopped state automatically.
    m_state = Stopped;
    return S_OK;
}

MENewPresentation

MENewPresentation事件會發出新簡報的開始訊號。 事件資料是新簡報的 IMFPresentationDescriptor 指標。

在許多情況下，您完全不會收到此事件。 如果您這麼做，請使用 IMFPresentationDescriptor 指標來建立新的播放拓撲，如 步驟 3：開啟媒體檔案所示。 然後將媒體會話上的新拓撲排入佇列。

//  Handler for MENewPresentation event.
//
//  This event is sent if the media source has a new presentation, which 
//  requires a new topology. 

HRESULT CPlayer::OnNewPresentation(IMFMediaEvent *pEvent)
{
    IMFPresentationDescriptor *pPD = NULL;
    IMFTopology *pTopology = NULL;

    // Get the presentation descriptor from the event.
    HRESULT hr = GetEventObject(pEvent, &pPD);
    if (FAILED(hr))
    {
        goto done;
    }

    // Create a partial topology.
    hr = CreatePlaybackTopology(m_pSource, pPD,  m_hwndVideo,&pTopology);
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the topology on the media session.
    hr = m_pSession->SetTopology(0, pTopology);
    if (FAILED(hr))
    {
        goto done;
    }

    m_state = OpenPending;

done:
    SafeRelease(&pTopology);
    SafeRelease(&pPD);
    return S_OK;
}

下一 步：步驟 6：控制項播放

相關主題

音訊/視訊播放

如何使用媒體基礎播放媒體檔案