Compartir a través de

Paso 1: Declarar la clase CPlayer

  • Artículo

Este tema es el paso 1 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.

En este tutorial, la funcionalidad de reproducción se encapsula en la CPlayer clase . La clase CPlayer se declara de la forma siguiente:

const UINT WM_APP_PLAYER_EVENT = WM_APP + 1;   

    // WPARAM = IMFMediaEvent*, WPARAM = MediaEventType

enum PlayerState
{
    Closed = 0,     // No session.
    Ready,          // Session was created, ready to open a file. 
    OpenPending,    // Session is opening a file.
    Started,        // Session is playing a file.
    Paused,         // Session is paused.
    Stopped,        // Session is stopped (ready to play). 
    Closing         // Application has closed the session, but is waiting for MESessionClosed.
};

class CPlayer : public IMFAsyncCallback
{
public:
    static HRESULT CreateInstance(HWND hVideo, HWND hEvent, CPlayer **ppPlayer);

    // IUnknown methods
    STDMETHODIMP QueryInterface(REFIID iid, void** ppv);
    STDMETHODIMP_(ULONG) AddRef();
    STDMETHODIMP_(ULONG) Release();

    // IMFAsyncCallback methods
    STDMETHODIMP  GetParameters(DWORD*, DWORD*)
    {
        // Implementation of this method is optional.
        return E_NOTIMPL;
    }
    STDMETHODIMP  Invoke(IMFAsyncResult* pAsyncResult);

    // Playback
    HRESULT       OpenURL(const WCHAR *sURL);
    HRESULT       Play();
    HRESULT       Pause();
    HRESULT       Stop();
    HRESULT       Shutdown();
    HRESULT       HandleEvent(UINT_PTR pUnkPtr);
    PlayerState   GetState() const { return m_state; }

    // Video functionality
    HRESULT       Repaint();
    HRESULT       ResizeVideo(WORD width, WORD height);
    
    BOOL          HasVideo() const { return (m_pVideoDisplay != NULL);  }

protected:
    
    // Constructor is private. Use static CreateInstance method to instantiate.
    CPlayer(HWND hVideo, HWND hEvent);

    // Destructor is private. Caller should call Release.
    virtual ~CPlayer(); 

    HRESULT Initialize();
    HRESULT CreateSession();
    HRESULT CloseSession();
    HRESULT StartPlayback();

    // Media event handlers
    virtual HRESULT OnTopologyStatus(IMFMediaEvent *pEvent);
    virtual HRESULT OnPresentationEnded(IMFMediaEvent *pEvent);
    virtual HRESULT OnNewPresentation(IMFMediaEvent *pEvent);

    // Override to handle additional session events.
    virtual HRESULT OnSessionEvent(IMFMediaEvent*, MediaEventType) 
    { 
        return S_OK; 
    }

protected:
    long                    m_nRefCount;        // Reference count.

    IMFMediaSession         *m_pSession;
    IMFMediaSource          *m_pSource;
    IMFVideoDisplayControl  *m_pVideoDisplay;

    HWND                    m_hwndVideo;        // Video window.
    HWND                    m_hwndEvent;        // App window to receive events.
    PlayerState             m_state;            // Current state of the media session.
    HANDLE                  m_hCloseEvent;      // Event to wait on while closing.
};

Estos son algunos aspectos que debe tener en cuenta sobre CPlayer:

  • La constante WM_APP_PLAYER_EVENT define un mensaje de ventana privada. Este mensaje se usa para notificar a la aplicación los eventos de sesión multimedia. Consulte Paso 5: Controlar eventos de sesión multimedia.
  • La PlayerState enumeración define los posibles estados del CPlayer objeto .
  • La CPlayer clase implementa la interfaz IMFAsyncCallback , que se usa para obtener notificaciones de eventos de la sesión multimedia.
  • El CPlayer constructor es privado. La aplicación llama al método estático CreateInstance para crear una instancia de la CPlayer clase .
  • El CPlayer destructor también es privado. La CPlayer clase implementa IUnknown, por lo que la duración del objeto se controla a través de su recuento de referencias (m_nRefCount). Para destruir el objeto, la aplicación llama a IUnknown::Release, no eliminar.
  • El CPlayer objeto administra tanto la sesión multimedia como el origen multimedia.

Implementación de IUnknown

La CPlayer clase implementa IMFAsyncCallback, que hereda IUnknown.

El código que se muestra aquí es una implementación bastante estándar de IUnknown. Si lo prefiere, puede usar la Biblioteca de plantillas activas (ATL) para implementar estos métodos. Sin embargo, CPlayer no admite CoCreateInstance ni ninguna característica COM avanzada, por lo que no hay ninguna razón abrumadora para usar ATL aquí.

HRESULT CPlayer::QueryInterface(REFIID riid, void** ppv)
{
    static const QITAB qit[] = 
    {
        QITABENT(CPlayer, IMFAsyncCallback),
        { 0 }
    };
    return QISearch(this, qit, riid, ppv);
}

ULONG CPlayer::AddRef()
{
    return InterlockedIncrement(&m_nRefCount);
}

ULONG CPlayer::Release()
{
    ULONG uCount = InterlockedDecrement(&m_nRefCount);
    if (uCount == 0)
    {
        delete this;
    }
    return uCount;
}

Siguiente: Paso 2: Crear el objeto CPlayer

Reproducción de audio y vídeo

Cómo reproducir archivos multimedia con Media Foundation