MFPlay 教程：视频播放

项目
07/24/2024

[与本页关联的功能 MFPlay 是一项旧版功能。它已被 MediaPlayer 和 IMFMediaEngine 取代。这些功能已针对 Windows 10 和 Windows 11 进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 和 IMFMediaEngine，而不是 DirectShow。如果可能，Microsoft 建议应重写使用旧 API 的现有代码，以尽可能地使用新的 API。]

本教程演示使用 MFPlay 播放视频的完整应用程序。它基于 SimplePlay SDK 示例。

本教程包含以下各节：

要求
标头和库文件
全局变量
声明回调类
声明 SafeRelease 函数
打开媒体文件
窗口消息处理程序
实现回调方法
实现 WinMain
相关主题

有关 MFPlay API 的更详细讨论，请参阅 MFPlay 入门。

要求

MFPlay 需要 Windows 7。

标头和库文件

在项目中包含以下标头文件：

#define WINVER _WIN32_WINNT_WIN7

#include <new>
#include <windows.h>
#include <windowsx.h>
#include <mfplay.h>
#include <mferror.h>
#include <shobjidl.h>   // defines IFileOpenDialog
#include <strsafe.h>
#include <Shlwapi.h>

链接到以下代码库：

mfplay.lib
shlwapi.lib

全局变量

声明以下全局变量：

IMFPMediaPlayer         *g_pPlayer = NULL;      // The MFPlay player object.
MediaPlayerCallback     *g_pPlayerCB = NULL;    // Application callback object.

BOOL                    g_bHasVideo = FALSE;

这些变量的用法如下：

g_hwnd: 应用程序窗口的句柄。
g_bVideo: 一个布尔值，用于跟踪视频是否正在播放。
g_pPlayer: 指向 IMFPMediaPlayer 接口的指针。此接口用于控制播放。
g_pCallback: 指向 IMFPMediaPlayerCallback 接口的指针。应用程序实现此回调接口，从播放器对象获取通知。

声明回调类

若要从播放器对象获取事件通知，应用程序必须实现 IMFPMediaPlayerCallback 接口。下面的代码声明一个实现此接口的类。唯一的成员变量是 m_cRef，用于存储引用计数。

IUnknown 方法以内联方式实现。稍后显示 IMFPMediaPlayerCallback::OnMediaPlayerEvent 方法的实现；请参阅实现回调方法。

// Implements the callback interface for MFPlay events.

class MediaPlayerCallback : public IMFPMediaPlayerCallback
{
    long m_cRef; // Reference count

public:

    MediaPlayerCallback() : m_cRef(1)
    {
    }

    IFACEMETHODIMP QueryInterface(REFIID riid, void** ppv)
    {
        static const QITAB qit[] =
        {
            QITABENT(MediaPlayerCallback, IMFPMediaPlayerCallback),
            { 0 },
        };
        return QISearch(this, qit, riid, ppv);
    }

    IFACEMETHODIMP_(ULONG) AddRef()
    {
        return InterlockedIncrement(&m_cRef);
    }

    IFACEMETHODIMP_(ULONG) Release()
    {
        ULONG count = InterlockedDecrement(&m_cRef);
        if (count == 0)
        {
            delete this;
            return 0;
        }
        return count;
    }

    // IMFPMediaPlayerCallback methods
    IFACEMETHODIMP_(void) OnMediaPlayerEvent(MFP_EVENT_HEADER *pEventHeader);
};

声明 SafeRelease 函数

在本教程中，SafeRelease 函数用于放开接口指针：

template <class T> void SafeRelease(T **ppT)
{
    if (*ppT)
    {
        (*ppT)->Release();
        *ppT = NULL;
    }
}

打开媒体文件

PlayMediaFile 函数将打开媒体文件，如下所示：

如果 g_pPlayer 为 NULL，该函数将调用 MFPCreateMediaPlayer 以创建媒体播放器对象的新实例。 MFPCreateMediaPlayer 的输入参数包括指向回调接口的指针和视频窗口的句柄。
若要打开媒体文件，该函数将调用 IMFPMediaPlayer::CreateMediaItemFromURL，并传入文件的 URL。此方法异步完成。完成后，调用应用程序的 IMFPMediaPlayerCallback::OnMediaPlayerEvent 方法。

HRESULT PlayMediaFile(HWND hwnd, PCWSTR pszURL)
{
    HRESULT hr = S_OK;

    // Create the MFPlayer object.
    if (g_pPlayer == NULL)
    {
        g_pPlayerCB = new (std::nothrow) MediaPlayerCallback();

        if (g_pPlayerCB == NULL)
        {
            return E_OUTOFMEMORY;
        }

        hr = MFPCreateMediaPlayer(
            NULL,
            FALSE,          // Start playback automatically?
            0,              // Flags
            g_pPlayerCB,    // Callback pointer
            hwnd,           // Video window
            &g_pPlayer
            );
    }

    // Create a new media item for this URL.

    if (SUCCEEDED(hr))
    {
        hr = g_pPlayer->CreateMediaItemFromURL(pszURL, FALSE, 0, NULL);
    }

    // The CreateMediaItemFromURL method completes asynchronously.
    // The application will receive an MFP_EVENT_TYPE_MEDIAITEM_CREATED
    // event. See MediaPlayerCallback::OnMediaPlayerEvent().

    return hr;
}

OnFileOpen 函数显示常用文件对话框，使用户能够选择要播放的文件。 IFileOpenDialog 接口用于显示通用文件对话框。此接口是 Windows Shell API 的一部分；它在 Windows Vista 中引入，作为旧版 GetOpenFileName 函数的替代项。用户选择文件后，OnFileOpen 调用 PlayMediaFile 以开始播放。

void OnFileOpen(HWND hwnd)
{
    IFileOpenDialog *pFileOpen = NULL;
    IShellItem *pItem = NULL;
    PWSTR pwszFilePath = NULL;

    // Create the FileOpenDialog object.
    HRESULT hr = CoCreateInstance(__uuidof(FileOpenDialog), NULL,
        CLSCTX_INPROC_SERVER, IID_PPV_ARGS(&pFileOpen));
    if (SUCCEEDED(hr))
    {
        hr = pFileOpen->SetTitle(L"Select a File to Play");
    }

    // Show the file-open dialog.
    if (SUCCEEDED(hr))
    {
        hr = pFileOpen->Show(hwnd);
    }

    if (hr == HRESULT_FROM_WIN32(ERROR_CANCELLED))
    {
        // User canceled.
        SafeRelease(&pFileOpen);
        return;
    }

    // Get the file name from the dialog.
    if (SUCCEEDED(hr))
    {
        hr = pFileOpen->GetResult(&pItem);
    }

    if (SUCCEEDED(hr))
    {
       hr = pItem->GetDisplayName(SIGDN_URL, &pwszFilePath);
    }

    // Open the media file.
    if (SUCCEEDED(hr))
    {
        hr = PlayMediaFile(hwnd, pwszFilePath);
    }

    if (FAILED(hr))
    {
        ShowErrorMessage(L"Could not open file.", hr);
    }

    CoTaskMemFree(pwszFilePath);

    SafeRelease(&pItem);
    SafeRelease(&pFileOpen);
}

窗口消息处理程序

接下来，为以下窗口消息声明消息处理程序：

WM_PAINT
WM_SIZE
WM_CLOSE

对于 WM_PAINT 消息，必须跟踪视频当前是否正在播放。如果是，则调用 IMFPMediaPlayer::UpdateVideo 方法。此方法使播放器对象重新绘制最新的视频帧。

如果没有视频，则应用程序负责绘制窗口。在本教程中，应用程序只需调用 GDI FillRect 函数来填充整个工作区。

void OnPaint(HWND hwnd)
{
    PAINTSTRUCT ps;
    HDC hdc = BeginPaint(hwnd, &ps);

    if (g_pPlayer && g_bHasVideo)
    {
        // Playback has started and there is video.

        // Do not draw the window background, because the video
        // frame fills the entire client area.

        g_pPlayer->UpdateVideo();
    }
    else
    {
        // There is no video stream, or playback has not started.
        // Paint the entire client area.

        FillRect(hdc, &ps.rcPaint, (HBRUSH) (COLOR_WINDOW+1));
    }

    EndPaint(hwnd, &ps);
}

对于 WM_SIZE 消息，调用 IMFPMediaPlayer::UpdateVideo。此方法使播放器对象重新调整视频以匹配窗口的当前大小。请注意，UpdateVideo 用于 WM_PAINT 和 WM_SIZE。

void OnSize(HWND /*hwnd*/, UINT state, int /*cx*/, int /*cy*/)
{
    if (state == SIZE_RESTORED)
    {
        if (g_pPlayer)
        {
            // Resize the video.
            g_pPlayer->UpdateVideo();
        }
    }
}

对于 WM_CLOSE 消息，请放开 IMFPMediaPlayer 和 IMFPMediaPlayerCallback 指针。

void OnClose(HWND /*hwnd*/)
{
    SafeRelease(&g_pPlayer);
    SafeRelease(&g_pPlayerCB);
    PostQuitMessage(0);
}

实现回调方法

IMFPMediaPlayerCallback 接口定义单个方法 OnMediaPlayerEvent。此方法在播放期间发生事件时通知应用程序。该方法采用一个参数，即指向 MFP_EVENT_HEADER 结构的指针。结构的 eEventType 成员指定发生的事件。

MFP_EVENT_HEADER 结构后跟其他数据。对于每个事件类型，定义一个宏，用于将 MFP_EVENT_HEADER 指针强制转换为特定于事件的结构。（请参阅 MFP_EVENT_TYPE。）

在本教程中，两个事件非常重要：

事件	说明
MFP_EVENT_TYPE_MEDIAITEM_CREATED	CreateMediaItemFromURL 完成时发送。
MFP_EVENT_TYPE_MEDIAITEM_SET	SetMediaItem 完成时发送。

以下代码演示如何将 MFP_EVENT_HEADER 指针强制转换为特定于事件的结构。

void MediaPlayerCallback::OnMediaPlayerEvent(MFP_EVENT_HEADER * pEventHeader)
{
    if (FAILED(pEventHeader->hrEvent))
    {
        ShowErrorMessage(L"Playback error", pEventHeader->hrEvent);
        return;
    }

    switch (pEventHeader->eEventType)
    {
    case MFP_EVENT_TYPE_MEDIAITEM_CREATED:
        OnMediaItemCreated(MFP_GET_MEDIAITEM_CREATED_EVENT(pEventHeader));
        break;

    case MFP_EVENT_TYPE_MEDIAITEM_SET:
        OnMediaItemSet(MFP_GET_MEDIAITEM_SET_EVENT(pEventHeader));
        break;
    }
}

MFP_EVENT_TYPE_MEDIAITEM_CREATED 事件通知应用程序 IMFPMediaPlayer::CreateMediaItemFromURL 方法已完成。事件结构包含指向 IMFPMediaItem 接口的指针，该接口表示从 URL 创建的媒体项。要对项排队用于播放，请将此指针传递给 IMFPMediaPlayer::SetMediaItem 方法：

void OnMediaItemCreated(MFP_MEDIAITEM_CREATED_EVENT *pEvent)
{
    // The media item was created successfully.

    if (g_pPlayer)
    {
        BOOL    bHasVideo = FALSE;
        BOOL    bIsSelected = FALSE;

        // Check if the media item contains video.
        HRESULT hr = pEvent->pMediaItem->HasVideo(&bHasVideo, &bIsSelected);
        if (SUCCEEDED(hr))
        {
            g_bHasVideo = bHasVideo && bIsSelected;

            // Set the media item on the player. This method completes
            // asynchronously.
            hr = g_pPlayer->SetMediaItem(pEvent->pMediaItem);
        }

        if (FAILED(hr))
        {
            ShowErrorMessage(L"Error playing this file.", hr);
        }
   }
}

MFP_EVENT_TYPE_MEDIAITEM_SET 事件通知应用程序 SetMediaItem 已完成。调用 IMFPMediaPlayer::Play 以开始播放：

void OnMediaItemSet(MFP_MEDIAITEM_SET_EVENT * /*pEvent*/)
{
    HRESULT hr = g_pPlayer->Play();
    if (FAILED(hr))
    {
        ShowErrorMessage(L"IMFPMediaPlayer::Play failed.", hr);
    }
}

实现 WinMain

在本教程的其余部分，不会调用 Media Foundation API。以下代码演示窗口过程：

LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    switch (uMsg)
    {
        HANDLE_MSG(hwnd, WM_CLOSE,   OnClose);
        HANDLE_MSG(hwnd, WM_PAINT,   OnPaint);
        HANDLE_MSG(hwnd, WM_COMMAND, OnCommand);
        HANDLE_MSG(hwnd, WM_SIZE,    OnSize);

    case WM_ERASEBKGND:
        return 1;

    default:
        return DefWindowProc(hwnd, uMsg, wParam, lParam);
    }
}

InitializeWindow 函数注册应用程序的窗口类并创建窗口。

BOOL InitializeWindow(HWND *pHwnd)
{
    const wchar_t CLASS_NAME[]  = L"MFPlay Window Class";
    const wchar_t WINDOW_NAME[] = L"MFPlay Sample Application";

    WNDCLASS wc = {};

    wc.lpfnWndProc   = WindowProc;
    wc.hInstance     = GetModuleHandle(NULL);
    wc.hCursor       = LoadCursor(NULL, IDC_ARROW);
    wc.lpszClassName = CLASS_NAME;
    wc.lpszMenuName  = MAKEINTRESOURCE(IDR_MENU1);

    RegisterClass(&wc);

    HWND hwnd = CreateWindow(
        CLASS_NAME, WINDOW_NAME, WS_OVERLAPPEDWINDOW,
        CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT,
        NULL, NULL, GetModuleHandle(NULL), NULL);

    if (!hwnd)
    {
        return FALSE;
    }

    ShowWindow(hwnd, SW_SHOWDEFAULT);
    UpdateWindow(hwnd);

    *pHwnd = hwnd;

    return TRUE;
}

最后，实现应用程序入口点：

int WINAPI wWinMain(HINSTANCE, HINSTANCE, PWSTR, int)
{
    HeapSetInformation(NULL, HeapEnableTerminationOnCorruption, NULL, 0);

    HRESULT hr = CoInitializeEx(NULL,
        COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE);

    if (FAILED(hr))
    {
        return 0;
    }

    HWND hwnd = NULL;
    if (InitializeWindow(&hwnd))
    {
        // Message loop
        MSG msg = {};
        while (GetMessage(&msg, NULL, 0, 0))
        {
            TranslateMessage(&msg);
            DispatchMessage(&msg);
        }

        DestroyWindow(hwnd);
    }
    CoUninitialize();

    return 0;
}

对音频/视频播放使用 MFPlay

通过

MFPlay 教程：视频播放

要求

标头和库文件

全局变量

声明回调类

声明 SafeRelease 函数

打开媒体文件

窗口消息处理程序

实现回调方法

实现 WinMain

反馈

其他资源

通过

MFPlay 教程：视频播放

要求

标头和库文件

全局变量

声明回调类

声明 SafeRelease 函数

打开媒体文件

窗口消息处理程序

实现回调方法

实现 WinMain

相关主题

反馈

其他资源