共用方式為


步驟 7:關閉媒體會話

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

若要關閉 媒體會話,請執行下列步驟:

  1. 呼叫 IMFMediaSession::Close 以關閉目前的簡報。
  2. 等候 MESessionClosed 事件。 此事件保證是媒體會話的最後一個事件。
  3. 呼叫 IMFMediaSession::Shutdown。 這個方法會使媒體會話釋放資源。
  4. 在目前的媒體來源上呼叫 IMFMediaSource::Shutdown

下列方法會關閉媒體會話。 它會使用事件控制碼 (m_hCloseEvent) 等候 MESessionClosed 事件。 請參閱 步驟 5:處理媒體會話事件

//  Close the media session. 
HRESULT CPlayer::CloseSession()
{
    //  The IMFMediaSession::Close method is asynchronous, but the 
    //  CPlayer::CloseSession method waits on the MESessionClosed event.
    //  
    //  MESessionClosed is guaranteed to be the last event that the 
    //  media session fires.

    HRESULT hr = S_OK;

    SafeRelease(&m_pVideoDisplay);

    // First close the media session.
    if (m_pSession)
    {
        DWORD dwWaitResult = 0;

        m_state = Closing;
           
        hr = m_pSession->Close();
        // Wait for the close operation to complete
        if (SUCCEEDED(hr))
        {
            dwWaitResult = WaitForSingleObject(m_hCloseEvent, 5000);
            if (dwWaitResult == WAIT_TIMEOUT)
            {
                assert(FALSE);
            }
            // Now there will be no more events from this session.
        }
    }

    // Complete shutdown operations.
    if (SUCCEEDED(hr))
    {
        // Shut down the media source. (Synchronous operation, no events.)
        if (m_pSource)
        {
            (void)m_pSource->Shutdown();
        }
        // Shut down the media session. (Synchronous operation, no events.)
        if (m_pSession)
        {
            (void)m_pSession->Shutdown();
        }
    }

    SafeRelease(&m_pSource);
    SafeRelease(&m_pSession);
    m_state = Closed;
    return hr;
}

在應用程式結束之前,請關閉媒體會話,然後呼叫 MFShutdown 來關閉 Microsoft Media Foundation 平臺。

//  Release all resources held by this object.
HRESULT CPlayer::Shutdown()
{
    // Close the session
    HRESULT hr = CloseSession();

    // Shutdown the Media Foundation platform
    MFShutdown();

    if (m_hCloseEvent)
    {
        CloseHandle(m_hCloseEvent);
        m_hCloseEvent = NULL;
    }

    return hr;
}

音訊/視訊播放

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