MFPlay 教學課程：視訊播放

發行項
07/19/2024

[與此頁面 MFPlay 相關聯的功能是舊版功能。它已被 MediaPlayer 和 IMFMediaEngine 取代。這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft強烈建議新程式代碼盡可能使用 MediaPlayer 和 IMFMediaEngine，而不是 DirectShow。 Microsoft建議使用舊版 API 的現有程式代碼，盡可能改寫成使用新的 API。]

本教學課程提供使用 MFPlay 播放影片的完整應用程式。它是以SimplePlay SDK 範例為基礎。

本教學課程包含下列各節：

需求
標頭和連結庫檔案
全域變數
宣告回調類別
宣告 SafeRelease 函式
開啟媒體檔案
視窗訊息處理程式
實作 Callback 方法
實作 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);
}

實作 Callback 方法

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：:P lay 開始播放：

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

實作 WinMain

在本教學課程的其餘部分中，不會呼叫媒體基礎 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 函式

開啟媒體檔案

視窗訊息處理程式

實作 Callback 方法

實作 WinMain

意見反應

其他資源

共用方式為

MFPlay 教學課程：視訊播放

需求

標頭和連結庫檔案

全域變數

宣告回調類別

宣告 SafeRelease 函式

開啟媒體檔案

視窗訊息處理程式

實作 Callback 方法

實作 WinMain

相關主題

意見反應

其他資源