Поделиться через

Шаг 2. Создание объекта CPlayer

  • Статья

Этот раздел является шагом 2 в учебнике Как воспроизвести файлы мультимедиа с помощью Media Foundation. Полный код показан в разделе пример воспроизведения сеансов мультимедиа.

Чтобы создать экземпляр класса CPlayer, приложение вызывает статический метод CPlayer::CreateInstance. Этот метод принимает следующие параметры:

  • hVideo указывает окно для отображения видео.
  • hEvent указывает окно для получения событий. Допустимо передать один и тот же дескриптор для обоих дескрипторов окон.
  • ppPlayer получает указатель на новый экземпляр CPlayer.

В следующем коде показан метод CreateInstance:

//  Static class method to create the CPlayer object.

HRESULT CPlayer::CreateInstance(
    HWND hVideo,                  // Video window.
    HWND hEvent,                  // Window to receive notifications.
    CPlayer **ppPlayer)           // Receives a pointer to the CPlayer object.
{
    if (ppPlayer == NULL)
    {
        return E_POINTER;
    }

    CPlayer *pPlayer = new (std::nothrow) CPlayer(hVideo, hEvent);
    if (pPlayer == NULL)
    {
        return E_OUTOFMEMORY;
    }

    HRESULT hr = pPlayer->Initialize();
    if (SUCCEEDED(hr))
    {
        *ppPlayer = pPlayer;
    }
    else
    {
        pPlayer->Release();
    }
    return hr;
}

HRESULT CPlayer::Initialize()
{
    // Start up Media Foundation platform.
    HRESULT hr = MFStartup(MF_VERSION);
    if (SUCCEEDED(hr))
    {
        m_hCloseEvent = CreateEvent(NULL, FALSE, FALSE, NULL);
        if (m_hCloseEvent == NULL)
        {
            hr = HRESULT_FROM_WIN32(GetLastError());
        }
    }
    return hr;
}

В следующем коде показан конструктор CPlayer:

CPlayer::CPlayer(HWND hVideo, HWND hEvent) : 
    m_pSession(NULL),
    m_pSource(NULL),
    m_pVideoDisplay(NULL),
    m_hwndVideo(hVideo),
    m_hwndEvent(hEvent),
    m_state(Closed),
    m_hCloseEvent(NULL),
    m_nRefCount(1)
{
}

Конструктор выполняет следующие действия:

  1. Вызывает MFStartup для инициализации платформы Media Foundation.
  2. Создает событие автоматического сброса. Это событие используется при закрытии сеанса мультимедиа; см. шаг 7. Завершение работы сеанса мультимедиа.

Деструктор завершает работу сеанса мультимедиа, как описано в шаге 7 ": Завершение сеанса мультимедиа".

CPlayer::~CPlayer()
{
    assert(m_pSession == NULL);  
    // If FALSE, the app did not call Shutdown().

    // When CPlayer calls IMediaEventGenerator::BeginGetEvent on the
    // media session, it causes the media session to hold a reference 
    // count on the CPlayer. 
    
    // This creates a circular reference count between CPlayer and the 
    // media session. Calling Shutdown breaks the circular reference 
    // count.

    // If CreateInstance fails, the application will not call 
    // Shutdown. To handle that case, call Shutdown in the destructor. 

    Shutdown();
}

Обратите внимание, что конструктор и деструктор являются защищенными методами класса. Приложение создает объект с помощью статического метода CreateInstance. Он удаляет объект вызовом IUnknown::Releaseвместо явного использования оператора delete.

Далее: шаг 3. Открытие файла мультимедиа

воспроизведение звука и видео

Воспроизведение файлов мультимедиа с помощью Media Foundation