IMFPMediaPlayer::UpdateVideo-Methode (mfplay.h)

Wichtig Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden. Anwendungen sollten die Mediensitzung für die Wiedergabe verwenden.

 

Updates den Videoframe aus.

Syntax

HRESULT UpdateVideo();

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDREQUEST	Das aktuelle Medienelement enthält kein Video.
MF_E_SHUTDOWN	Die Shutdown-Methode des Objekts wurde aufgerufen.

Hinweise

Rufen Sie diese Methode auf, wenn das Videowiedergabefenster Ihrer Anwendung entweder eine WM_PAINT- oder WM_SIZE-Nachricht empfängt. Diese Methode führt zwei Funktionen aus:

• Stellt sicher, dass der Videoframe neu gezeichnet wird, während die Wiedergabe angehalten oder beendet wird.
• Passt das angezeigte Video an die aktuelle Größe des Videofensters an.

Wichtig Rufen Sie die GDI BeginPaint-Funktion auf, bevor Sie UpdateVideo aufrufen.

 

Beispiele

IMFPMediaPlayer *g_pPlayer;

LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    HDC hdc;
    PAINTSTRUCT ps;

    switch (uMsg)
    {
    case WM_PAINT:
        hdc = BeginPaint(hwnd, &ps);
        if (g_pPlayer)
        {
            g_pPlayer->UpdateVideo();
        }
       	EndPaint(hwnd, &ps);
        break;

    case WM_SIZE:        
        hdc = BeginPaint(hwnd, &ps);
        if (g_pPlayer)
        {
            g_pPlayer->UpdateVideo();
        }
       	EndPaint(hwnd, &ps);
        break;

    // other messages

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfplay.h

Weitere Informationen

IMFPMediaPlayer

Verwenden von MFPlay für die Audio-/Videowiedergabe