Paso 2: Crear el objeto CPlayer

Este tema es el paso 2 del tutorial Cómo reproducir archivos multimedia con Media Foundation. El código completo se muestra en el tema Ejemplo de reproducción de sesión multimedia.

Para crear una instancia de la CPlayer clase , la aplicación llama al método estático CPlayer::CreateInstance . Este método toma los parámetros siguientes:

• hVideo especifica la ventana que se va a mostrar el vídeo.
• hEvent especifica una ventana para recibir eventos. Es válido pasar el mismo identificador para ambos identificadores de ventana.
• ppPlayer recibe un puntero a una nueva CPlayer instancia.

En el código siguiente se muestra el método 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;
}

El código siguiente muestra el CPlayer constructor :

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)
{
}

El constructor hace lo siguiente:

1. Llama a MFStartup para inicializar la plataforma de Media Foundation.
2. Crea un evento de restablecimiento automático. Este evento se usa al cerrar la sesión multimedia; consulte Paso 7: Apagar la sesión multimedia.

El destructor apaga la sesión multimedia, como se describe en paso 7: Apagar la sesión multimedia.

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

Tenga en cuenta que el constructor y el destructor son métodos de clase protegidos. La aplicación crea el objeto mediante el método estático CreateInstance . Destruye el objeto llamando a IUnknown::Release, en lugar de usar explícitamente delete.

Siguiente: Paso 3: Abrir un archivo multimedia

Temas relacionados

Reproducción de audio y vídeo

Cómo reproducir archivos multimedia con Media Foundation