IMFPMediaPlayer::RepaintVideo Method

[This documentation is preliminary and is subject to change.]
Repaints the current video frame.

Important  Call the GDI BeginPaint function before calling RepaintVideo.

Syntax

HRESULT RepaintVideo();

Parameters

This method has no parameters.

Return Value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description

S_OK

The method succeeded.

MF_E_INVALIDREQUEST

The current media item does not contain video.

MF_E_SHUTDOWN

The object's Shutdown method was called.

Remarks

This method ensures that the video frame is repainted while playback is paused or stopped. Call this method whenever your application receives a WM_PAINT message, if both of the following conditions are true:

  • Desktop Window Manager (DWM) composition is disabled.
  • Playback is paused or stopped.

If DWM composition is enabled, you do not need to call RepaintVideo. To find out whether DWM composition is enabled, call DwmIsCompositionEnabled.

Requirements

Client Requires Windows 7.
Header Declared in Mfplay.h.

See Also

IMFPMediaPlayer
Using MFPlay for Audio/Video Playback

Send comments about this topic to Microsoft

Build date: 4/3/2009