Étape 1 : déclarer la classe CPlayer
Cette rubrique est l’étape 1 du didacticiel Comment lire des fichiers multimédias avec Media Foundation. Le code complet est présenté dans la rubrique exemple de lecture de session multimédia.
Dans ce didacticiel, la fonctionnalité de lecture est encapsulée dans la CPlayer classe. La classe CPlayer est déclarée comme suit :
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.
};
Voici quelques points à noter CPlayer :
- L' événement de _ _ joueur d' _ application WM constant définit un message de fenêtre privée. Ce message est utilisé pour notifier l’application des événements de session multimédia. Consultez étape 5 : gérer les événements de session multimédia.
- L'
PlayerStateénumération définit les États possibles de l'CPlayerobjet. - La
CPlayerclasse implémente l’interface IMFAsyncCallback , qui est utilisée pour recevoir des notifications d’événements à partir de la session multimédia. - Le
CPlayerconstructeur est privé. L’application appelle laCreateInstanceméthode statique pour créer une instance de laCPlayerclasse. - Le
CPlayerdestructeur est également privé. LaCPlayerclasse implémente IUnknown, de sorte que la durée de vie de l’objet est contrôlée par son décompte de références (m _ nRefCount). Pour détruire l’objet, l’application appelle IUnknown :: Release, et non Delete. - L'
CPlayerobjet gère à la fois la session multimédia et la source du média.
Implémenter IUnknown
La CPlayer classe implémente IMFAsyncCallback, qui hérite de IUnknown.
Le code présenté ici est une implémentation relativement standard de IUnknown. Si vous préférez, vous pouvez utiliser la Active Template Library (ATL) pour implémenter ces méthodes. Toutefois, CPlayer ne prend pas en charge CoCreateInstance ni les fonctionnalités com avancées, donc il n’y a aucune raison d’utiliser ATL ici.
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;
}
Étape 2 : créer l’objet CPlayer