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